Octop

项目简介

Octop 是一个可自托管的开源智能协作伙伴，面向个人和团队。其 Octop Memory 组件为 LLM 智能体提供持久、可移植的记忆，可捕获、提取、回忆、存储和迁移对话上下文，并支持 Python 库、CLI 和 JSON-RPC 桥接等方式接入。

核心功能

• 一次部署，人人有专属助手：一台机器运行一套服务，家人和同事可拥有只记得自己事情的助手，切换角色不必切换环境。
• 连接常用账号与工具：可授权腾讯文档、腾讯会议、Notion、邮箱等，用一句话完成信息整理，减少复制粘贴。
• 与编辑器和终端协作：复杂改动可通过 ACP 派给专业编程 Agent，由用户验收结果。
• 具备电脑操作能力：可在终端执行命令、在浏览器填写表单并自动截图，遇到阻碍才请求用户确认。
• 桌面宠物常驻：OctopPet 悬浮桌面，随叫随到，无需打开浏览器即可提问。
• Octop Memory 持久记忆：支持模型辅助提取、召回排序、实体页与情景组织、导出导入，以及 SQLite 或 PostgreSQL 存储。

适用场景

• 个人快速问答：通过桌面宠物或主界面随时向智能伙伴提问。
• 团队共享部署：一台服务为家人和同事提供各自独立上下文的专属助手。
• 会议与文档整理：连接腾讯会议、腾讯文档等账号后，把会议结论整理进文档。
• 编程协作：将复杂代码改动派给专业编程 Agent，用户负责验收结果。

快速开始

• 官网提供三步上手，可复制安装命令运行，程序会自动准备需要的东西。
• 支持一键安装、pip 安装、Docker 安装和下载客户端等方式。
• Octop Memory 可通过 pip install octop-memory 安装，并使用 Python API 或 CLI 创建本地数据库。
• Octop Memory 可选安装 cli、postgres、langgraph、langgraph-postgres 等依赖组。

部署与要求

• Octop Memory 要求 Python 3.12+，核心依赖为零，可使用 SQLite 本地起步，或使用 PostgreSQL 进行服务器部署。
• 自动提取、提升检查和页面再生成需要注入 LLMClient；仅安装软件包不会配置模型。
• Octop 支持自托管，数据可保留在本地；网站提供 Docker 安装方式。
• 向量检索默认未启用，使用需初始化索引并注入 vector_index 和 embedding_provider。

采用前须知

• 许可证：MIT。在使用、修改或分发项目前，请确认其具体条款。
• Octop Memory 的自动提取、提升检查和页面再生成依赖外部注入的 LLMClient，单独安装不会配置模型。
• 向量检索接口与 Chroma/Qdrant 适配器虽在代码中存在，但真实集成尚未验证，且默认未启用。
• PostgreSQL 行为测试需连接真实测试服务器，跳过的 PG 用例不能证明兼容性。