open-octo/octo-agent

오픈 소스, 단일 바이너리, 자체 호스팅 AI 에이전트.

Claude Code에 필적하는 코딩 에이전트이자 개인 비서 역할을 수행하며, OpenClaw보다 가볍습니다. Node / Python / Ruby가 필요 없는 MIT 라이선스의 Go 바이너리로, 어떤 모델 (DeepSeek, Kimi, Anthropic, OpenAI 또는 호환 가능한 모든 모델)에서도 실행되며, 서버와 사용자의 데이터는 자신의 기기에 안전하게 유지됩니다.

웹사이트 · 简体中文 · 설치 가이드 · 문서화 · 커뮤니티

octo가 유용하다고 생각되시면 GitHub에서 ⭐를 눌러주세요!

octo는 "구축"해야 하는 또 다른 에이전트 프레임워크가 아닙니다. OpenClaw나 Hermes 같은 프로젝트들은 에이전트가 원활하게 작동하기 전에 환경 튜닝, 규칙 작성, 스킬 구성 등이 필요한 경우가 많습니다. octo는 Codex나 WorkBuddy에 더 가깝습니다: 다운로드하여 사용하면 되며 사용자 친화적이지만, 모델 선택, 데이터 소유권, 런타임은 전적으로 사용자의 손에 남겨둡니다.

curl -fsSL https://octo-agent.dev/install.sh | sh # 단일 바이너리 — Node / Ruby / Python 불필요
octo "Add a --json flag to 'octo config show' and run the tests" # 하나의 프롬프트로 → 완전한 에이전트 루프(full agentic loop) 구현

octo는 이러한 포지셔닝을 중심으로 구축되었습니다.

설치 즉시 사용 가능: 셸, 파일 읽기/쓰기/편집, 검색, MCP 서버, 스킬, 서브 에이전트가 기본적으로 모두 활성화되어 있습니다. 설치 후 메시지 한 번만 보내면 실제로 작동할 준비가 됩니다.모델 선택은 사용자에게: 모든 OpenAI / Anthropic 프로토콜 호환 엔드포인트를 네이티브로 지원합니다. 벤더 종속성(vendor lock-in)이 없습니다.데이터는 기기에 유지: 자체 호스팅되며, 원격 측정(telemetry) 데이터가 전혀 전송되지 않습니다. 분석 자료, 충돌 보고서, 사용량 신호, CDN 등이 없습니다. 사용자가 요청하지 않아도 단 하나의 요청만 발생합니다: 데이터를 포함하지 않는 GitHub에 대한 버전 확인입니다. update_check: false로 설정하세요.

그리고 octo는 아무것도 만들지 않습니다. 기계에서 나가는 것은 오직 사용자가 설정한 모델 API 호출과 요청한 도구 호출뿐입니다.어디서든: 동일한 바이너리가 TUI, CLI, 웹, 데스크톱, IM, 에디터 확장 프로그램, 모바일의 여덟 가지 진입점을 제공합니다.안전 기본값: 치명적인 명령어는 하드코딩된 거부 사항이며, 삭제 및 덮어쓰기는 먼저 재활용함에 백업됩니다. 따라서 이 에이전트는 스스로를 망가뜨리거나 사용자 데이터에서 벗어나지 않습니다.

이미 Codex나 Claude 구독에 대한 신뢰할 수 있는 액세스가 있다면 계속 사용하세요. 여전히 지구상 최고의 에이전트 활용처입니다. 그렇지 않다면, octo는 진지하게 살펴볼 가치가 있습니다.

단일 ~40 MB Go 바이너리: 다운로드하여 어떤 서버로든 복사하고 실행하는 단 하나의 명령어만 필요합니다. Node/Python/Ruby 의존성 트리가 없고, npm 미러, node-gyp 빌드 실패 또는 버전 충돌 문제에 시달릴 필요가 없습니다.캐시 저하 없음: 프롬프트 캐싱은 제공업체별로 조정됩니다. Kimi, DeepSeek, Qwen의 측정된 적중률은 모두 **99%+**이며, 토큰 청구서를 예측 가능하게 유지합니다.여덟 가지 인터페이스: TUI, CLI, 웹 UI, 데스크톱 앱, IM 브릿지, VS Code, Obsidian, 모바일 등—한 번에 이 많은 진입점을 다루는 다른 에이전트 프로젝트는 거의 없습니다.제로 텔레메트리: IP 주소, 장치 모델, 모델 선택 또는 사용 행동을 수집하지 않습니다. 텔레메트리 후크가 전혀 없습니다. 웹 UI는 필요한 모든 자산을 자체적으로 포함합니다—아이콘은 번들링되고 텍스트는 시스템 글꼴을 사용하므로 열어도 CDN에 아무것도 건드리지 않습니다. octo가 네트워크에 대해 묻는 유일한 것은 더 새로운 릴리스가 존재하는지 여부이며, 이는 하나의 설정 스위치만 거르면 조용히 처리됩니다.데스크톱 설치 프로그램은 약 100 MB: 이것을 Codex 데스크톱이나 WorkBuddy와 비교해보면, 이들은 종종 1 GB 정도의 크기를 가집니다. 가벼운 에이전트 활용처가 그렇게 많은 공간을 차지할 필요는 없습니다.안정적이고 안전함: 자체 보호 기능, 우아한 재시작(graceful restarts), 그리고 재활용함 안전망(Core Features 참조)을 제공합니다.

이 중 어떤 포인트든 다른 제품에 의해 구현되었을 수 있습니다. 하지만 octo만이 사용 준비가 된 편의성(out-of-the-box usability), 네이티브 멀티모달 지원, 여덟 가지 인터페이스, 단일 바이너리, 제로 텔레메트리(zero telemetry), 작은 크기(small footprint), 높은 안정성, 그리고 강력한 안전성을 결합합니다.

octo (단일 바이너리)
-> TUI 대화형 터미널 세션
-> CLI octo "prompt" 또는 파이프된 stdin: 헤드리스 에이전트 작업(agentic turn)을 한 번 수행하고 종료 — cron, CI 또는 자체 프로그램에서 스크립팅 가능
...

Stable (1.0) 버전은 이미 TUI, CLI, Web UI, 데스크톱, IM 브릿지, 그리고 VS Code / Obsidian 확장 기능을 지원합니다. 여덟 번째인 모바일 앱(iOS + Android)은 구현되어 개발자 미리보기(developer preview) 단계에 있으며, 오늘날 자체 호스팅 릴레이를 대상으로 소스에서 빌드할 수 있습니다 ( mobile/ 참조). 향후에는 호스팅 릴레이 및 앱 스토어 빌드가 이어질 예정입니다.

내장 도구(셸, 파일 읽기/쓰기/편집, 검색), MCP 서버, 스킬, 그리고 서브 에이전트는 기본적으로 활성화되어 있습니다. 환경 조정, 규칙 작성, 또는 스킬 구성에 앞서 별도의 작업이 필요하지 않습니다 — 설치 후 메시지 한 번으로 실제로 작동할 수 있습니다.

DeepSeek, Kimi, Qwen, Anthropic, OpenAI 또는 모든 OpenAI / Anthropic 호환 엔드포인트를 octo가 네이티브하게 지원합니다. 프롬프트 캐싱은 제공업체별로 조정되며, 히트율(hit rates)은 99% 이상입니다. Claude Code에 타사 모델을 전면 배치하여 설정 오류로 인해 캐시 히트율이 급락하는 방식과 달리, octo는 토큰 청구액을 예측 가능하게 유지합니다.

• 터미널 도구는 octo 자체 프로세스를 겨냥한 모든 kill, /pkill, /killall 명령을 거부합니다. 심지어 kill $(pgrep octo)와 같은 우회 경로도 마찬가지입니다. 서버 재시작(restart_server) 기능은 항상 먼저 권한을 요청하도록 하드 와이어링 되어 있습니다 — 웹에서는 브라우저 모달로, IM에서는 명시적인 답변으로요. 승인 후에도 재시작 과정은 부드럽습니다: 현재 작업이 소진되어 슈퍼바이저가 서버를 다시 시작하고 클라이언트가 재연결되기 전에 귀하의 답변이 도착합니다.- 모든 삭제는 검증됩니다. rm -rf /나 rm -rf ~와 같은 치명적인 명령어는 사용자 지정 권한 규칙으로도 무효화할 수 없는 **하드 코딩된 거부(hard-coded denies)**입니다. 일반 파일 삭제 및 write_file / edit_file

덮어쓰기된 내용은 먼저 재활용함(recycle bin)에 백업됩니다 (기본 14일 / 10 GiB). 따라서 어떤 것도 영원히 사라지지 않습니다. 게다가 원하는 경우 OS에서 강제하는 격리 환경(macOS Seatbelt / Linux Landlock)을 활성화할 수도 있습니다.

SKILL.md 형식은 Claude Code와 호환됩니다 — 심볼릭 링크 ~/.claude/skills를 사용하고 기존의 것을 재사용할 수 있습니다.

대규모 도구 세트를 위한 stdio + HTTP 전송, OAuth 및 Tool Search 기능을 지원합니다.

세션 간 메모리(Cross-session memory), 병렬 서브 에이전트, 다중 에이전트 워크플로우 오케스트레이션을 제공합니다.

Go 네이티브 CDP 기록/재생/자가 복구 기능을 갖추었습니다.

octo를 채팅 앱에 연결하여 WeChat, Feishu 또는 Telegram에서 작업을 수행할 수 있습니다.

Linux / macOS—curl -fsSL https://octo-agent.dev/install.sh | sh

Windows—irm https://octo-agent.dev/install.ps1 | iex

제한된 네트워크 환경—github.com에 접속할 수 없는 경우, 다운로드 미러를 사용하십시오 (설치 및 octo upgrade도 자동으로 이 미러로 폴백됩니다):curl -fsSL https://dl.octo-agent.dev/install.sh | sh

(Windows:irm https://dl.octo-agent.dev/install.ps1 | iex)

데스크톱 앱— 최신 릴리스에서 설치 프로그램을 가져가세요: octo-setup.pkg (macOS), octo-setup.exe (Windows), Octo-x86_64.AppImage (Linux)

Go—go install github.com/open-octo/octo-agent/cmd/octo@latest

언제든지 octo upgrade로 업그레이드할 수 있습니다.

플랫폼 세부 정보 — Gatekeeper / SmartScreen 경고, 제거, 소스 빌드는 설치 가이드에 나와 있습니다. 설치 프로그램은 아직 코드 서명되지 않았으며, 전체 정책 및 해시를 통해 릴리스를 확인하는 방법은 SECURITY.md에 나와 있습니다.

octo serve -d # 로컬 서버 시작 (Web UI + IM 브릿지)

**http://127.0.0.1:8088**을 열면 설정 패널이 안내를 진행합니다: 언어를 선택하고, 모델을 연결한 다음, 사용자의 이름, 어시스턴트의 성격, 그리고 원하는 행동 방식을 학습하는 짧은 채팅을 거칩니다. Loopback은 접근 키가 필요 없습니다. 데스크톱 앱은 네이티브 창을 가진 동일한 서버입니다 — 대신 이것을 실행하여 브라우저 단계로 바로 건너뛸 수 있습니다.

터미널 사용을 선호하십니까? 제공업체 연결 후에는 추가 설정 없이 동일한 에이전트를 사용할 수 있습니다:

octo "이 저장소 설명하기" # 헤드리스(headless) 원샷: 프롬프트 → 에이전트 도구 루프 → 종료
octo # 터미널에서 대화형 TUI; octo -c는 세션 재개
octo config # 브라우저를 건드리지 않고 제공자 설정하기

다음 단계: 빠른 시작 · 제공자 선택 · CLI 레퍼런스.

• 단 하나의 명령어로 설치:
  curl -fsSL https://octo-agent.dev/install.sh | sh

. - 서버 시작 —
octo serve -d

— 또는 데스크톱 앱을 실행하는데, 이는 동일한 서버입니다. - http://127.0.0.1:8088에서 열고 설정하기를 따르세요: 언어, 모델, 그리고 어시스턴트와 사용자가 누구인지 작성하는 온보딩 채팅.

• 컴포저(composer)로부터 실제 작업을 부여하세요 — 단순히 답변만 필요한 것이 아니라 셸(shell), 파일 또는 웹이 필요한 작업입니다.
• 실행
  octo "이 저장소 설명하기"

헤드리스 원샷을 위해, 또는 터미널 TUI를 위해 octo를 사용합니다. — 동일한 에이전트, 동일한 설정. - IM 채널을 구성하고 WeChat / Feishu / Telegram에서 대화를 이어가세요.

• 필요한 만큼 스킬(skills), MCP 서버, 하위 에이전트를 추가하세요.

┌────────────────────────────────┐
│ 8가지 인터페이스 │
│ TUI · CLI · Web UI · IM │
...

레이어드 디자인(layered design), 제공자 프로토콜(provider protocols) 및 확장 방법에 대해서는 아키텍처 문서(architecture docs)를 참조하세요.

전체 문서는 octo-agent.dev/docs에 있습니다:

• 스킬(Skills) — Claude Code와 호환되는 SKILL.md; ~/.claude/skills에 심볼릭 링크하여 보유한 것을 재사용하세요 - 샌드박싱 및 휴지통(Sandboxing & recycle bin) — OS가 강제하는 격리(Seatbelt / Landlock), 그리고 에이전트 삭제를 백업하고 덮어쓰는 파일 레벨의 쓰레기통
• MCP 서버 — stdio + HTTP, OAuth, 대규모 도구 세트를 위한 도구 검색(Tool Search)
• 메모리 · 하위 에이전트 · 워크플로우 — 지속성 및 다중 에이전트 오케스트레이션
• 브라우저 자동화 — CDP 기록/재생/자가 복구(CDP record / replay / self-heal)
• IM 채널 — 채팅 앱에 octo를 연결(hook)하세요
• 설정 · 권한 · 도구
• 아키텍처 — 레이어드 디자인, 제공자 프로토콜 및 확장 방법

버그/기능 요청— GitHub IssuesWeChat 그룹(중국어 사용자) — 아래 QR 코드를 스캔하고 개인 계정에 추가한 후 octo를 언급하세요.

그룹에 초대받으려면:

make build # ./octo
make test # go test -race ./...

프로젝트 컨벤션은 CLAUDE.md와 .octorules에 있습니다.

; PR 워크플로우는 CONTRIBUTING.md에 있습니다.

.

octo가 1.0 안정 버전을 출시했습니다. TUI, CLI, Web UI, 데스크톱, IM 브릿지 및 에디터 확장은 모두 신뢰할 수 있으며; 모바일은 개발자 프리뷰 상태입니다. 구축할 수 있는 내용은 COMPATIBILITY.md에 명시되어 있으며; 보안 경계는 SECURITY.md를 참고하십시오.

octo는 두 프로젝트의 성과 위에 서 있으며, 그렇게 가장합니다: 에이전트 루프, 도구 세트, SKILL.md 형식 및 하네스 동작으로 octo의 내부 설계를 형성한 Claude Code와 UI 및 상호 작용 디자인의 많은 부분을 영감받은 OpenClacky입니다. 버그나 잘못된 결정은 모두 octo 자체의 것입니다.

octo에 기여한 모든 분들께 감사드립니다:

전체 기록은 기여자 그래프(contributors graph)에서 확인할 수 있습니다.

MIT 라이선스. LICENSE.txt를 참조하십시오.