
FAAAH 项目发布:用纯文本文件协议将 AI Agent 订阅转为 OpenAI 兼容本地服务
来源标题:Faaah (Filesystem as an AI Handler) – Agent Subscription as OpenAI API via Files
FAAAH 是一个零依赖的开源工具,能把已付费的 AI Agent 订阅当作 OpenAI 兼容的本地服务器复用,无需再单独购买 API key。它由 308 行 Python 代码实现,采用纯文本文件协议,可充当任何期待 OpenAPI 的工具与任意 LLM 之间的中立代理。作者称本地非商业使用据其理解不违反各 AI Agent 服务商的 ToS。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
你所能找到的最简单的兼容 OpenAI 的 LLM 代理。™️
FAAAH 让你能把自己的 AI Agent 订阅当作通用的、兼容 OpenAI 的本地服务器来复用。
FAAAH 零依赖,以纯文本文件协议实现(符合 UNIX 哲学):
既然你已经为 AI 编程助手付了钱,就别再为周末副业项目单独买 API key 了!faaah!
它同时也是任何期望 OpenAPI 的工具与任何 LLM 之间的中立代理。
举个例子,看看完全通过 FAAAH 驱动的 GraphRAG。
demo-9mb.mp4
这允许吗?
据我理解,本工具的本地、非商业使用并不违反任何 AI agent 提供商的现有 ToS。
但如果有律师不同意,请给我发消息。届时我会把你介绍给我的一个朋友:Barbra Streisand 女士。
使用 FAAAH 处理海量数据集时要谨慎。有些提供商(你知道是哪几家)可能会对其含糊的 ToS 做出卡夫卡式的解读,并部署奥威尔式的遥测来检测违规(我还没遇到过,YOLO!)
零依赖:用的是 Python 的 http.server。就这样。
308 行代码:你见过这个领域其他工具的臃肿程度吗?恶心。
Unix 哲学:一切皆文件。把一件事做好。保持 KISS,懂吧,YAGNI。
通用兼容性:只要一个工具支持事实上的 OpenAI API 格式(GraphRAG、LangChain、LlamaIndex、LiteLLM、openai SDK),它就支持 FAAAH。
Agent 中立:由于 agent 入口是一个 prompt,它不绑定任何特定的 agent 提供商/版本。面向未来。
Human-in-the-loop 兜底:如果 AI agent 卡住了或触发了用量限制,你可以直接打开当前的响应文件(比如 response-0004.txt),自己输入答案(或把请求复制粘贴到你喜欢的网页聊天机器人),然后保存。FAAAH 就会成功。
用法
0. 安装
在本仓库内用 uv 安装:
uv tool install . # 把 faaah 命令安装到 PATH
uv tool install .[embeddings] # 附带本地 embeddings 扩展(见后文)
或者直接从 git 仓库安装:
uv tool install git+https://github.com/sebastiancarlos/faaah
- 启动服务器
faaah # 监听 127.0.0.1:8000,队列 ~/.cache/faaah/queue
faaah --port 8080 # 覆盖端口
faaah --queue /tmp/q # 覆盖队列目录
faaah --log-dir /tmp/logs # 覆盖会话日志根目录(见下文)
faaah -c # 同时把 agent prompt 复制到剪贴板
每次运行都会创建一个会话日志目录(默认 ~/.cache/faaah/sessions/<TIMESTAMP>-<RANDOM>),镜像该次运行期间写入或应答的每个队列文件,这样即使队列在重启时被清空,你也能调试某次会话:
传 --log-dir "" 可禁用会话日志。
agent prompt 会在启动时打印。要再次获取它:
faaah --agent-message
把它粘贴到你的编程 agent 中,它随后会启动一个 FAAAH 协调循环:
注意:FAAAH 使用 subagent 来避免在多个请求上耗尽上下文。因此,你的 AI Agent 必须支持按 prompt 请求创建 subagent。
curl http://127.0.0.1:8000/v1/chat/completions
-H "Content-Type: application/json"
-H "Authorization: Bearer anything"
-d '{ "model": "faaah
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。