Octop Harness

项目简介

Octop Harness 是一个基于 Harness Engineering 理念的生产级智能体运行时，也是对 deepagents 的封装工程层。它把 create_deep_agent 原语扩展为可用于生产的运行时，提供多提供商模型路由、持久化分层记忆、浏览器与搜索工具、多智能体注册表、可插拔存储后端和终端 CLI。与此同时，Octop 作为自托管助手，可为个人和团队提供可并行运作的智能协作体验。

核心功能

• 基于 deepagents 的 create_deep_agent 构建，提供面向生产的智能体封装与运行时。
• ChatModelFactory 支持 OpenAI、Anthropic、AWS Bedrock 以及 17 个可编辑提供商预设。
• 分层记忆：每轮捕获为 L0 原始事件，并异步蒸馏为 L2 原子卡与 L3 实体页面。
• 内置浏览器自动化、网页搜索、文件操作、子智能体、MCP 工具以及可选图像/视频生成工具。
• AgentManager 可在单进程运行多个隔离智能体，并通过 ACP stdio 服务器供 IDE 或终端 AI 调用。
• 工作区后端可插拔：本地磁盘、S3、COS 或 PostgreSQL；安全策略包含工具护栏、文件系统权限与 PII 脱敏。

适用场景

• 个人和团队可在一台机器部署服务，为家人和同事提供各自独立的专属助手，并按任务切换分析师、研究员等角色。
• 授权连接腾讯文档、腾讯会议、Notion、邮箱等账号后，可用自然语言把会议结论整理进文档。
• 可与编辑器和终端协作，通过 ACP 将复杂改动派给专业编程 Agent，由用户验收结果。
• 可执行终端命令、打开网页填写表单、自动截图等电脑操作；桌面宠物可常驻桌面随时提问。

快速开始

• 前置条件：Python 3.12+，以及一个模型提供商 API 密钥（OpenAI / Anthropic / Bedrock / 兼容）。
• 安装核心 SDK：pip install octop-harness；如需终端 CLI：pip install octop-harness[cli]。
• 初始化并配置提供商：运行 octop-harness init 和 octop-harness config provider add。
• 运行 octop-harness chat 开始交互式聊天。

部署与要求

• Python 3.12+。
• 需要一个模型提供商 API 密钥（OpenAI / Anthropic / Bedrock / 兼容）。
• 可选依赖 extras 包括 cli、bedrock、object-storage、desktop、web-search-all、remote-backends、observability、acp、all；缺失 extras 会在使用时失败并给出安装提示。
• 工作区可选用本地磁盘、S3、COS 或 PostgreSQL 后端；Postgres 需要 remote-backends extra，S3 使用内置 boto3 后端。
• 桌面端与自托管场景强调数据保留在自有环境，官网提供下载客户端与 macOS 安装签名问题 FAQ。

采用前须知

• 许可证：MIT。在使用、修改或分发项目前，请确认其具体条款。
• 该项目定位为库而非独立应用，并封装 deepagents；采用时需考虑对 deepagents 的依赖。
• 部分功能依赖可选依赖项，缺失时会在使用时失败并给出安装提示。
• 产品强调自托管，聊天、文件和密钥保留在自有环境中。