sebastiancarlos/faaah

★ 8PythonMIT

코딩 AI 구독을 텍스트 파일 몇 개로 API처럼 재사용하는 로컬 프록시

FAAAH는 Claude Code, opencode 같은 이미 구독 중인 AI 코딩 에이전트를 OpenAI API처럼 쓸 수 있게 해주는 도구다. 요청을 클라우드 API로 보내는 대신 폴더 안 txt 파일로 저장하고, 이미 쓰던 코딩 에이전트가 그 파일을 읽고 답을 다시 txt 파일로 써주면 이를 OpenAI 형식 JSON으로 포장해 돌려준다. 파이썬 표준 라이브러리만으로 308줄로 구현되어 있고 스타는 8개다.

무엇을 하는 레포인가

의존성 없이 파이썬 내장 http.server만으로 만든 OpenAI 호환 로컬 서버로, 요청이 오면 프롬프트를 폴더에 txt 파일(prompt-00001.txt 등)로 저장한다
사용자는 기존에 구독 중인 Claude Code, opencode 같은 코딩 에이전트에게 이 폴더를 감시하고 응답 파일(response-00001.txt)을 쓰라고 지시만 하면 된다
faaah --watch 명령으로 코디네이터 루프를 돌리며, 실제 작업은 서브에이전트(작업자)에게 위임해 하나의 대화 맥락이 계속 쌓이는 걸 막는다
응답이 없으면 같은 요청을 계속 재제공하는 자동 재시도 구조이며, 에이전트가 막히면 사람이 직접 응답 파일에 답을 써넣는 것도 가능하다
선택 기능으로 spaCy 기반 로컬 임베딩(en_core_web_md)을 지원해 /v1/embeddings 엔드포인트도 제공한다

왜 중요한가

이미 돈을 내고 있는 AI 코딩 어시스턴트 구독을 별도의 API 요금 없이 GraphRAG, LangChain 같은 OpenAI API 호환 도구와 연결해 부업 프로젝트에 활용할 수 있다. 다만 이런 사용이 각 AI 제공사의 이용약관과 충돌할 수 있어 저장소 자체도 이 점을 명시하고 있다.

이 레포의 용어

OpenAI-compatible API · OpenAI가 정한 요청/응답 형식을 그대로 따르는 방식으로, 이 형식만 맞추면 다른 도구들과 쉽게 연동된다
서브에이전트(subagent) · 코디네이터가 요청마다 새로 띄우는 작업용 하위 에이전트로, 대화 맥락이 무한정 쌓이는 것을 막는다
uv · 파이썬 패키지·툴 설치 및 실행을 관리하는 도구
임베딩(embeddings) · 텍스트를 숫자 벡터로 바꿔 의미 유사도를 계산할 수 있게 하는 표현 방식

레포 원문 소개 (영문)

FAAAH (Filesystem As An AI Handler) - Reuse your AI Agent subscription via text files.

GitHub에서 보기

주목받는 레포

레포 전체 보기 →

sebastiancarlos/faaah

무엇을 하는 레포인가

왜 중요한가

이 레포의 용어

주목받는 레포

METAL MEDIA 최신 기사