ONEDEV

gptme

AI Coding ToolsCLIPython

★ 4,411주당 +11조회 4

무엇인가

gptme는 2023년 3월 첫 커밋으로 공개된 초기 에이전트 CLI 중 하나이며, Claude Code·Codex·Cursor·Warp가 놓인 자리를 대체하는 오픈소스 도구다. 코딩에 강하지만 지식 작업 전반을 돕는 범용 개인 에이전트를 표방하고, 노트북·SSH 세션·tmux·헤드리스 서버·CI 파이프라인처럼 터미널이 있는 환경에서 같은 방식으로 동작한다.

어떻게 동작하나

동작은 도구 호출 루프다. 모델 출력이 다시 어시스턴트에게 피드백되어 스스로 오류를 고친다. 내장 도구로 shell, python, patch(증분 파일 수정), browser(Playwright 기반), vision, tmux, morph가 있고 백그라운드 작업·비용 추적·콘텐츠 주소 지정 저장소를 갖춘다. Lessons 시스템은 키워드·도구·패턴 매칭으로 상황에 맞는 지침을 컨텍스트에 자동 삽입하며 대화형 모드와 자율 모드에 따라 다르게 적용된다. 플러그인과 스킬로 확장하고 MCP·ACP로 외부 도구와 에디터에 연결한다. gptme-server는 REST API를 노출하고 gptme-webui를 함께 제공한다.

무엇과 다른가

제공자 중립성이 핵심 차이다. Anthropic·OpenAI·Google·xAI·DeepSeek·OpenRouter를 설정으로 바꿀 수 있고 llama.cpp로 완전 로컬 실행도 가능하다. API 키 대신 기존 ChatGPT Plus/Pro나 SuperGrok 구독을 그대로 쓰는 방식도 지원한다. 작업별로 모델을 라우팅해 분류에는 빠르고 저렴한 모델을, 코딩에는 강한 모델을 배정한다. 데이터와 모델 선택이 사용자 쪽에 남는다는 점에서 제공자에 종속된 상용 에이전트 CLI와 구조가 다르다.

어떻게 쓰나

Python 패키지로 배포되며 터미널에서 gptme를 실행해 대화를 시작한다. 대화형 CLI는 diff·구문 강조, 탭 완성, 명령 히스토리를 제공한다. 서버 모드로 띄우면 REST API와 웹 UI(chat.gptme.org)로 같은 도구에 접근할 수 있고, PyInstaller 독립 실행 파일과 Linux AppImage·macOS·Windows 데스크톱 앱(자동 업데이트 포함)도 배포된다. 자율 에이전트는 gptme-agent-template으로 만들고 gptme-contrib의 커뮤니티 플러그인(Twitter/X, Discord 봇, 이메일, 멀티에이전트 consortium)을 붙인다.

전제와 한계

Python으로 작성되어 Python 실행 환경이 필요하다. 모델은 외부 제공자 자격 증명이나 로컬 llama.cpp 서버 중 하나가 있어야 하며 비전 기능은 이미지를 처리하는 모델에 의존한다. 도구 실행은 사용자의 로컬 환경에서 직접 일어나므로 셸·파일 접근 권한이 그대로 에이전트에 넘어간다. 자율 실행은 별도 템플릿과 실행 루프 구성이 전제다.

관련 논문 3

유사 도구