원문: TencentCloud/Octop · 수집일: 2026-09-20 · 라이선스: MIT
개요
Octop의 목적은 개인이나 소규모 조직이 자신의 컴퓨터에 AI 어시스턴트와 여러 전문 에이전트를 함께 운영하도록 만드는 것이다. README가 말하는 핵심은 “개인정보를 외부 SaaS에 맡기지 않고, 여러 사용자가 각자의 에이전트를 쓰며, 웹·메신저·CLI·자동화를 한 프로세스에서 공유한다”는 운영 모델이다.
프로젝트의 목적
Octop은 단일 채팅 앱보다 self-hosted AI 운영면(control plane)에 가깝다. 사용자의 대화·workspace·credential을 ~/.octop/에 두고, 하나의 프로세스가 웹 대시보드와 CLI, IM 채널, cron을 동일한 처리 파이프라인으로 연결한다. 기본은 SQLite(WAL)이지만 PostgreSQL도 선택 가능하다.
이 구조가 해결하려는 문제는 다음과 같다.
- 여러 업무별 전문 에이전트를 한 환경에서 전환하고 병렬로 운용하기
- 가족이나 소규모 팀이 하나의 배포에서 사용자별 에이전트·권한·workspace를 공유하기
- Feishu·DingTalk·QQ·Discord·WeCom·웹·API를 별도 봇이 아니라 통합된 에이전트 표면으로 연결하기
- 문서 RAG, 영속 메모리, OAuth/MCP connector, 플러그인을 개인 데이터 경계 안에서 조합하기
- IDE/터미널 코딩 에이전트와 ACP로 연결하고, 승인 게이트를 둔 채 작업을 위임하기
실제 용도
개인 어시스턴트
주간 보고서 작성, 메모 정리, 일정 관리처럼 반복적인 개인 업무를 전담 에이전트에 맡길 수 있다. workspace에 메모리가 붙어 대화 맥락을 유지하는 것이 중요한 사용 시나리오다.
가족 공유
관리자 계정 하나로 가정 구성원을 관리하면서 사용자마다 다른 에이전트와 전문가를 배정하는 모델이다. 따라서 개인용 앱과 팀용 챗봇의 중간 지점을 노린다.
팀 협업·ChatOps
그룹 채팅에서 들어온 작업을 여러 전문 에이전트로 라우팅하고, Feishu·DingTalk·WeCom 같은 업무 메신저에서 결과를 돌려받는 용도다. Web UI·IM·cron이 같은 HarnessProcessor로 처리된다는 점이 핵심이다.
개발자 보조
ACP inbound로 Zed·OpenCode 같은 외부 클라이언트가 Octop 에이전트를 호출하거나, outbound로 OpenCode·CodeBuddy·Claude Code·Codex에 코딩 작업을 위임할 수 있다. 브라우저의 Terminal AI+로 명령 실행·문제 해결을 보조하는 용도도 포함된다.
웹 자동화·지식 검색·예약 실행
Browser AI+는 headless Chromium 세션과 persistent profile을 사용해 폼 입력, 스크린샷, 공개 정보 수집을 지원한다. 문서 코퍼스에는 RAG를 적용하고, 자연어 또는 slash command로 cron 작업을 등록할 수 있다.
기술 구조
| 층 | 확인된 구성 |
|---|---|
| 런타임 | Python 3.12+, harness-agent |
| 서버 | FastAPI + uvicorn |
| 통합 게이트웨이 | harness-gateway — IM 메시지를 단일 파이프라인으로 정규화 |
| 메모리·브라우저 | harness-memory, harness-browser |
| 제어면 DB | SQLite(WAL) 기본, PostgreSQL 선택 |
| UI | React 18 + TypeScript + Vite + Ant Design |
| 예약 실행 | APScheduler |
| IDE/에이전트 통합 | Agent Client Protocol(ACP) |
아키텍처의 특징은 외부 queue나 message broker 대신 in-process HarnessProcessor를 중심에 둔다는 점이다. 재시작하면 제어면 DB에서 상태를 다시 구성하는 single-process 모델이므로, 설치와 운영은 단순해지는 반면 고가용성·수평 확장은 별도 검토가 필요하다. 마지막 문장은 README 구조에서 도출한 해석이다.
보안과 운영 경계
README는 JWT 기반 다중 사용자 격리, tool approval, shell command guardrail, PII redaction, workspace backend 격리를 보안 기능으로 제시한다. 다만 이 노트는 기능 선언을 정리한 것이며 실제 공격 저항성이나 외부 connector별 권한 범위를 검증한 보안 감사가 아니다.
모든 런타임 상태가 ~/.octop/에 모인다는 점은 self-hosting의 장점이면서 백업·권한·비밀 관리의 운영 책임을 사용자에게 돌린다. Docker 운용 시 /data/.octop 볼륨과 초기 관리자 credential 파일을 보호해야 한다.
판단 메모
Octop은 “모델 호출 라이브러리”나 “코딩 에이전트 하나”가 아니라, 여러 에이전트와 여러 입력 채널을 개인 인프라 안에서 운영하는 통합 하네스로 보는 편이 정확하다. 특히 harness-* 런타임, ACP, connector/MCP, RAG, cron을 한 배포에 묶은 점이 차별점이다.
반대로 README만으로는 실제 multi-agent 협업의 자동 조정 수준, connector의 성숙도, 다중 사용자 권한 모델의 세부 정책, 운영 규모 한계를 판단할 수 없다. 프로덕션 도입 전에는 설치 후 사용자 격리·승인 흐름·백업/복구·채널 토큰 노출·ACP 위임 범위를 별도로 검증해야 한다.
관련 노트
출처와 수집 범위
원문 포인터와 수집 메타데이터는 raw source: 2026-09-20-github-tencentcloud-octop에 보존했다. GitHub README·raw README·REST 메타데이터를 확인했으며, 실제 설치/실행과 보안 검증은 수행하지 않았다.