Octop

项目简介

Octop 是一个开源的自托管 AI 助手平台，面向家庭和小型团队。它以单一进程运行，提供 Web 仪表盘、CLI、IM 渠道、定时自动化与 API 服务，所有数据都保存在本机 ~/.octop/ 目录下。

核心功能

• 多用户、多智能体运行，支持 JWT 身份验证、按用户划分的智能体和管理员角色。
• 本地优先的自托管设计，配置、聊天、工作区和凭据都保存在你自己的机器上。
• 提供 Web 仪表盘、CLI、桌面客户端，以及 HTTP/SSE/WebSocket API 访问方式。
• IM 渠道支持飞书、钉钉、QQ、微信、Telegram、Discord 和 WeCom。
• 专家库、MBTI 人格模板、专家分享，以及用于多步骤任务的 AgentTeams 测试版。
• 知识库 RAG、插件、带 OAuth 和 MCP 的连接器，以及面向 IDE 工作流的 ACP 集成。

适用场景

• 个人助理，用于撰写周报、整理笔记、安排日程并保持记忆持久化。
• 家庭共享，一个管理员账号，每位成员可使用不同的智能体或专家。
• 团队助手，打通 IM 平台并将任务路由到群聊。
• 开发者助力，通过 ACP 委派给 OpenCode 或 Claude Code，并支持终端 AI 和浏览器自动化。

快速开始

• 在 macOS 或 Linux 上使用一行安装命令安装，在 Windows 上使用 PowerShell 或 cmd 安装脚本。
• 运行 octop init，在 ~/.octop/ 下创建 SQLite 数据库、JWT 密钥和第一个管理员账号。
• 运行 octop run，然后在本地 8088 端口打开 Web 仪表盘。
• 生产环境推荐使用 Docker Compose；首次启动会创建管理员账号，并在未设置 OCTOP_DEFAULT_PASSWORD 时将凭据写入 /data/.octop/credential.txt。

部署与要求

• 支持的操作系统包括 macOS、Linux 和 Windows。
• 无需预先安装 Python；安装程序会使用 uv 在 ~/.octop/ 下的隔离 venv 中配置 Python 3.12。
• 建议使用现代多核 CPU 和数 GB 内存，以支持进程以及模型和嵌入缓存，并留有足够磁盘空间存放数据库、智能体工作区和文档语料库。
• 控制平面默认使用 SQLite，可选 PostgreSQL；工作区后端可包括本地磁盘、Docker 沙箱、PostgreSQL 或 COS/S3。

采用前须知

• 许可证：MIT。在使用、修改或分发项目前，请确认其具体条款。