TencentCloud / Octop

A smarter, self-hosted AI assistant — multi-user, multi-agent. 一个更智能、可自托管的 AI 助手——支持多用户、多智能体。

Highlights · Overview · Core Technology · Features · Roadmap · Quick Start · Contents

亮点 · 概览 · 核心技术 · 功能 · 路线图 · 快速开始 · 目录

Octop is an open-source, self-hosted AI assistant. It’s not just a tool — it’s a digital life form that can operate in parallel. Through its multi-agent architecture, it builds an intelligent environment that is both independent and collaborative for teams, families, and individuals. Best of all, it runs entirely on your machine — the fully self-hosted design means privacy is never a compromise, while single-process startup makes the powerful web console, CLI, and IM integrations readily accessible. Chat through the Web Dashboard, Feishu, DingTalk, QQ, Discord, WeCom, or programmatic HTTP/SSE/WebSocket. Extend capabilities with the expert library, Connectors (OAuth + MCP), and ACP integration for IDE workflows.

Octop 是一个开源的、可自托管的 AI 助手。它不仅仅是一个工具，更是一个可以并行运行的“数字生命体”。通过其多智能体架构，它为团队、家庭和个人构建了一个既独立又协作的智能环境。最棒的是，它完全运行在你的机器上——完全自托管的设计意味着隐私绝不妥协，而单进程启动方式使得强大的 Web 控制台、CLI 和即时通讯（IM）集成变得触手可及。你可以通过 Web 仪表盘、飞书、钉钉、QQ、Discord、企业微信或编程接口（HTTP/SSE/WebSocket）进行对话。此外，还可以通过专家库、连接器（OAuth + MCP）以及用于 IDE 工作流的 ACP 集成来扩展功能。

✨ Highlights / 亮点

👥 Multi-user expert team: One admin, shared household; built-in expert library — switch specialists per scenario. 多用户专家团队： 一个管理员，共享家庭空间；内置专家库——可根据场景切换专家。
🎭 MBTI personas: 16 personality templates plus an interactive quiz — give each agent a distinct character. MBTI 人格： 16 种人格模板加上互动测试——赋予每个智能体独特的性格。
🔒 Security built-in: JWT multi-user isolation, tool approval, shell command guardrails, and PII redaction — data stays local. 内置安全机制： JWT 多用户隔离、工具审批、Shell 命令防护栏以及个人隐私信息（PII）脱敏——数据始终保留在本地。
🔌 Connector ecosystem: Tencent suite (Docs, Weibo trends, News, …); OAuth and MCP gateway extend resource boundaries. 连接器生态： 腾讯套件（文档、微博热搜、新闻等）；OAuth 和 MCP 网关扩展了资源边界。
💾 Pluggable backends: Local disk, Docker containers, PostgreSQL, or COS/S3 — AI operates inside isolated boundaries. 可插拔后端： 本地磁盘、Docker 容器、PostgreSQL 或 COS/S3——AI 在隔离的边界内运行。
🧠 Portable memory: Powered by harness-memory; memory migrates with the workspace. 便携式记忆： 由 harness-memory 驱动；记忆随工作区迁移。
📚 Knowledge base: RAG over your documents; semantic retrieval grounds agent answers in your private corpus. 知识库： 基于文档的 RAG（检索增强生成）；语义检索使智能体的回答基于你的私有语料库。
🧩 Plugins: Extend Octop with third-party plugins; bundled plugins are seeded and toggled on demand. 插件： 使用第三方插件扩展 Octop；捆绑插件可按需启用。
↔️ ACP bidirectional: octop acp for IDE/terminal AI; delegate to OpenCode / Claude Code with permission gates. ACP 双向支持： 用于 IDE/终端 AI 的 octop acp；通过权限控制委托给 OpenCode / Claude Code。
💻 Terminal AI+: Interactive shell in the browser — AI-assisted command execution and troubleshooting. 终端 AI+： 浏览器中的交互式 Shell——AI 辅助命令执行和故障排查。
🌐 Browser AI+: Headless Chromium sessions for web automation, screenshots, and remote browsing. 浏览器 AI+： 用于网页自动化、截图和远程浏览的无头 Chromium 会话。
🖥️ Remote desktop: Live screen and input from the dashboard on Linux, Windows, and macOS — remote office work and GUI apps; one-click isolated desktop on headless Linux. 远程桌面： 在 Linux、Windows 和 macOS 上通过仪表盘进行实时屏幕查看和输入——支持远程办公和 GUI 应用；在无头 Linux 上一键开启隔离桌面。
🏠 Self-hosted: Dashboard, CLI, IM channels, and cron in one octop run — all data under ~/.octop/. 自托管： 仪表盘、CLI、IM 频道和定时任务（cron）均在一次 octop 运行中完成——所有数据存储在 ~/.octop/ 下。

📌 Overview / 概览

Octop is a self-hosted AI assistant platform for households and small teams. It runs a single process that serves a web dashboard, a CLI, IM channels (Feishu, DingTalk, QQ, Discord, WeCom, and more), and cron automation — all sharing one control-plane database under ~/.octop/ (SQLite by default; PostgreSQL optional). Octop’s design goal: keep every conversation, workspace, and credential on your own machine, while giving each user a personal team of specialized agents they can switch between per task.

Octop 是一个面向家庭和小团队的自托管 AI 助手平台。它通过单一进程运行，提供 Web 仪表盘、CLI、IM 频道（飞书、钉钉、QQ、Discord、企业微信等）以及定时任务自动化——所有功能共享 ~/.octop/ 下的一个控制平面数据库（默认为 SQLite，可选 PostgreSQL）。Octop 的设计目标是：将每一次对话、工作区和凭据都保留在你的机器上，同时为每个用户提供一个专属的专家智能体团队，用户可以根据任务需求在不同智能体之间切换。

🐾 What can you do with Octop / 你可以用 Octop 做什么

Personal assistant: Let a dedicated agent write weekly reports, organize notes, and manage your schedule; memory persists with the workspace. 个人助理： 让专属智能体撰写周报、整理笔记并管理日程；记忆随工作区持久化。
Family sharing: One admin account, the whole household; assign different agents and experts per member. 家庭共享： 一个管理员账号，全家使用；为每位成员分配不同的智能体和专家。
Team helper: Multiple agents collaborate in parallel, bridging Feishu / DingTalk / WeCom to route tasks into group chats. 团队助手： 多个智能体并行协作，连接飞书/钉钉/企业微信，将任务路由到群聊中。
Developer boost: Delegate coding tasks to OpenCode / Claude Code via ACP, or troubleshoot from the terminal with AI assistance. 开发者助力： 通过 ACP 将编码任务委托给 OpenCode / Claude Code，或在终端通过 AI 辅助进行故障排查。
Web automation: Use Browser AI+ to fill forms, capture screenshots, and gather public info. 网页自动化： 使用浏览器 AI+ 填写表单、截取屏幕并收集公开信息。
Scheduled tasks: Configure cron in natural language so the agent pushes or runs jobs on time every day. 定时任务： 用自然语言配置定时任务，让智能体每天准时推送或执行工作。

🧠 Core Technology / 核心技术

Layer	Technology
Language	Python 3.12+
Web framework	FastAPI + uvicorn
Agent runtime	harness-agent
Gateway	harness-gateway
Control plane DB	SQLite (WAL, default) or PostgreSQL (optional)
Frontend	React 18 + TypeScript + Vite + Ant Design
Scheduling	APScheduler
ACP	agent-client-protocol
Build / quality	hatchling · ruff · mypy · pytest

Octop is built on the Harness stack — a set of focused runtimes that Octop composes into one process: Octop 基于 Harness 技术栈构建——这是一套专注于运行时的组件，Octop 将它们组合成一个进程：

harness-agent: Agent runtime: model routing, tools, skills, and conversation checkpointing. harness-agent： 智能体运行时：模型路由、工具、技能和对话检查点。
harness-gateway: multi-platform IM channel bridge that normalizes incoming messages into a single processing pipeline. harness-gateway： 多平台 IM 频道桥接器，将传入的消息标准化为单一处理流水线。
harness-memory: hierarchical recall with full-text search, so an agent’s memory travels with its workspace. harness-memory： 具备全文搜索的分层回溯功能，使智能体的记忆随工作区同步。
harness-browser: CDP-based browser automation with persistent profiles for web tasks. harness-browser： 基于 CDP 的浏览器自动化，支持网页任务的持久化配置。

Instead of an external queue or message broker, Octop routes every surface — Web UI, IM, and cron — through one in-process HarnessProcessor. The result is a single, restart-safe process whose entire state is rebuilt from the control-plane database on boot (local SQLite by default; PostgreSQL optional).

Octop 不依赖外部队列或消息代理，而是通过一个进程内的 HarnessProcessor 路由所有交互界面（Web UI、IM 和定时任务）。其结果是一个单一的、支持重启的进程，启动时会从控制平面数据库（默认为本地 SQLite，可选 PostgreSQL）重建所有状态。