FAAAH: un proxy LLM compatible con OpenAI basado en archivos de texto

Fuentes: FAAAH: a dependency-free OpenAI-compatible LLM proxy backed by text files

FAAAH (Filesystem As An AI Handler) es una herramienta de código abierto que actúa como proxy local compatible con la API de OpenAI y permite reutilizar la suscripción de un agente de programación con IA —como Claude Code u opencode— para alimentar otras aplicaciones que esperan el formato OpenAI. Su diseño sigue la filosofía UNIX: no tiene dependencias externas (solo usa http.server de Python), ocupa 308 líneas de código y se reduce a un protocolo basado en archivos de texto. Cuando una aplicación envía una petición al proxy, FAAAH la vuelca como un fichero prompt-.txt en un directorio de cola (por defecto ~/.cache/faaah/queue). El agente de IA lee esa petición, genera un borrador (response-.txt.draft) y, tras revisarlo, lo renombra como response-.txt. FAAAH recoge la respuesta y la empaqueta en JSON compatible con OpenAI para devolverla al cliente.

El flujo se gestiona con un coordinador que invoca faaah --watch para obtener la siguiente petición pendiente, la delega a un subagente para evitar agotar el contexto y reintenta automáticamente si no aparece respuesta. La herramienta es agnóstica del proveedor y del modelo, funciona con cualquier cliente que respete la API OpenAI (SDK oficial, LangChain, LlamaIndex, LiteLLM, GraphRAG) e incluye un modo de intervención manual: si el agente se atasca, el usuario puede escribir él mismo la respuesta en el fichero correspondiente. Se instala con uv tool install y escucha por defecto en 127.0.0.1:8000. Su autor aclara que el uso local y no comercial no vulnera, en su opinión, los términos de servicio de los proveedores de agentes.