sebastiancarlos/faaah
A local proxy that turns your existing AI coding subscription into an OpenAI-style API using plain text files
FAAAH lets you reuse an AI coding agent you already pay for, like Claude Code or opencode, as a generic OpenAI-compatible server. Instead of hitting a cloud API, requests are dumped as .txt files in a folder, your existing agent reads and answers them as other .txt files, and FAAAH packages the reply back into OpenAI-shaped JSON. It's dependency-free, written in about 308 lines of Python, with 8 stars on GitHub.
What it does
- Built with nothing but Python's built-in http.server, it writes each incoming request as a prompt-00001.txt style file in a queue folder
- You tell your already-subscribed coding agent (Claude Code, opencode, etc.) to watch that folder and write answers back as response-00001.txt files
- A faaah --watch loop drives a 'coordinator' that delegates each request to a subagent worker, which prevents context from piling up across many requests
- If a response file never appears, the same prompt is simply re-offered for automatic retry, and a human can manually edit a draft response if the agent gets stuck
- An optional spaCy-based local embeddings feature serves a /v1/embeddings endpoint when the extra dependency is installed
Why it matters
It lets side-project developers plug OpenAI-API-expecting tools like GraphRAG, LangChain, or LlamaIndex into an AI subscription they already pay for, without buying separate API credits. The README itself flags that this usage may sit in a gray area of providers' terms of service, which readers should weigh before relying on it.
Terms in this repo
- OpenAI-compatible API · a request/response format matching OpenAI's API shape, letting any tool built for it work with a different backend
- subagent · a worker agent spun up per request by the coordinator so conversation context doesn't accumulate indefinitely
- uv · a tool for installing and running Python packages and CLI tools
- embeddings · numeric vector representations of text used to compare meaning or similarity
Repository description (English)
FAAAH (Filesystem As An AI Handler) - Reuse your AI Agent subscription via text files.
Open on GitHubTrending repos
- vorssaint/vorssaint-utilsOne free menu bar app replaces a dozen paid Mac utilities
- Alishahryar1/free-claude-codeA local proxy that lets coding AI agents run on 49 free or cheap model providers instead of one paid service
- freestylefly/awesome-gpt-image-2A library of 532 reverse-engineered prompts that turn GPT-Image2 into a predictable image-making tool
- block/buzzAn open-source workspace where humans and AI agents chat, code, and review in the same rooms
- NousResearch/hermes-agentNous Research's Hermes is an AI agent that gets smarter the more you use it
- virgiliojr94/book-to-skillA tool that turns technical book PDFs into on-demand reference skills for AI coding agents
- VoltAgent/awesome-agent-skillsA single hub collecting over 1000 'how-to' manuals that make AI coding assistants act like experts
- anthropics/claude-plugins-communityA shared shelf where anyone's Claude add-ons get listed for install