sebastiancarlos/faaah
用几个文本文件,把你已经付费的AI编程助手变成OpenAI式接口
FAAAH让你把已经订阅的Claude Code、opencode等AI编程助手复用为一个通用的OpenAI兼容本地服务器。它不把请求发到云端API,而是把请求存成文件夹里的txt文件,让你原本使用的编程助手读取并把回答写成另一个txt文件,FAAAH再把结果打包成OpenAI格式的JSON返回。整个工具零依赖,用Python写了大约308行代码,在GitHub上有8颗星。
它做什么
- 仅用Python自带的http.server实现,把每个请求写成队列文件夹里的prompt-00001.txt之类的文件
- 用户只需让自己已经订阅的编程助手(Claude Code、opencode等)监视这个文件夹,并把答案写成response-00001.txt文件即可
- 通过faaah --watch驱动一个协调循环,把每个请求委派给子代理(subagent)worker处理,避免多个请求的上下文不断堆积
- 如果一直没有生成回复文件,系统会自动把同一个请求重新提供以便重试;若代理卡住,用户也可以手动编辑草稿文件给出答案
- 可选的基于spaCy的本地嵌入功能,在安装额外依赖后提供/v1/embeddings接口
为什么重要
这让开发者可以把GraphRAG、LangChain等需要OpenAI接口的工具接到自己已经付费的AI编程订阅上,不必再单独购买API额度来做周末小项目。不过README也提醒,这种用法可能处于各家服务条款的灰色地带,使用前需要自行权衡。
本仓库术语
- OpenAI兼容接口 · 遵循OpenAI请求和响应格式的接口规范,只要符合这个格式就能与各种现有工具对接
- 子代理(subagent) · 协调器为每个请求临时启动的工作代理,用来防止对话上下文无限累积
- uv · 用于安装和运行Python包与命令行工具的工具
- 嵌入(embeddings) · 把文本转换成数字向量,用于计算语义相似度的表示方式
仓库简介（英文）
FAAAH (Filesystem As An AI Handler) - Reuse your AI Agent subscription via text files.
在 GitHub 打开热门仓库
- vorssaint/vorssaint-utils一个免费菜单栏应用,顶替十几款付费Mac工具
- Alishahryar1/free-claude-code一个本地代理,把编程AI助手接到49家免费或低价模型服务商,不再只能用一家付费服务
- freestylefly/awesome-gpt-image-2把532个GPT-Image2案例拆解成可复用模板的提示词工程库
- block/buzz一个让人类和AI智能体在同一空间里聊天、写代码、做审查的开源协作平台
- NousResearch/hermes-agentNous Research推出的Hermes是一款越用越聪明的AI智能体
- virgiliojr94/book-to-skill把技术类书籍PDF变成AI编程助手随时可查阅的技能包
- VoltAgent/awesome-agent-skills把上千份让AI编程助手秒变专家的操作手册集中放在一个地方
- anthropics/claude-plugins-community一个把大家做的Claude插件集中起来供安装的仓库