Octop

自托管多用户 AI 助手，本地部署保隐私，长期记忆更懂你

Octop 是一个自托管的智能 AI 助手，专注于多用户、多智能体协作场景。它解决了个人或团队在本地环境中部署和使用 AI 助手时面临的隐私、定制化和协作问题。核心能力包括：支持多个用户同时使用，每个用户可拥有独立的智能体配置；内置长期记忆功能，能记住用户偏好和历史对话；采用本地优先架构，数据默认存储在自己的服务器上，保障隐私安全。项目基于 Python 构建，技术栈涵盖 agentic-ai、local-first 和 long-term-memory 等方向，适合希望深度掌控 AI 助手的开发者和团队。目前项目处于早期阶段，星标数接近千，社区活跃度尚可。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 4737

维护状态活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队TencentCloud

所属国家

官网地址https://octop.cloud

GitHubhttps://github.com/TencentCloud/Octop

定价模式free

价格说明开源项目，MIT许可证，可免费自托管部署，无付费版本。

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型agent,agentic-ai,ai,ai-agent,ai-agents,local-first,long-term-memory

GitHub 星标★ 4737

30天Star增速

HF 下载量

上线时间2026-07-08 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：入门约 10 分钟部署方式：本地安装 7 步

环境要求

Python 3.12+（使用 pip/PyPI 方式安装时需要）
macOS / Linux / Windows 均可，安装脚本会创建隔离环境
一键安装需能访问 finnie-1258344699.cos.ap-guangzhou.myqcloud.com
安装后需新开终端或重载 shell 以启用命令

安装与启动步骤

1macOS/Linux 一键安装

官方推荐方式，脚本自动在 ~/.octop/venv 创建隔离环境，不会改动系统 Python。
```
curl -fsSL https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.sh | bash
```
2Windows PowerShell 安

在 PowerShell 中执行官方远程安装脚本；安装完成后同样会生成 octop 入口。
```
irm https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.ps1 | iex
```
3Windows cmd 安装

cmd 用户先下载 install.bat 再运行；也可改用已克隆仓库里的 install.bat。
```
curl -fsSL https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.bat -o install.bat
install.bat
```
4重载 shell 环境

README 要求安装后打开新终端或重载 shell，让 ~/.octop/bin 下的命令生效（示例为 Zsh）。
```
source ~/.zshrc
```
5可选：浏览器能力

需要浏览器相关扩展能力时安装该可选依赖，README 标注为 optional。
```
pip install "octop[browser]"
```
6可选：本地嵌入模型

可选安装本地 ONNX embedding 模型缓存，对应界面中的 Models → Local。
```
pip install "octop[local-embedding]"
```
7启动 Octop

README 节选未给出具体启动命令，安装器已生成 ~/.octop/bin/octop 入口，请按该入口和官方文档启动。

关键配置

配置项	必填	说明	示例
`~/.octop/`	是	全部运行时状态与配置的存放目录，可通过 CLI 或直接编辑文件管理	`/home/user/.octop/`

如何确认成功

新开终端后检查 ~/.octop/venv 与 ~/.octop/bin/octop 是否生成，且 octop 命令可直接调用。

常见问题

Q：一键安装会污染系统 Python 吗？

A：不会。所有安装脚本都在 ~/.octop/venv 创建隔离环境，并提供 ~/.octop/bin/octop 包装命令，不动系统 Python。

Q：不想用远程脚本怎么安装？

A：可用 PyPI 方式：pip install octop（需 Python 3.12+）；或克隆仓库后执行 bash scripts/install.sh，Windows 用 scriptsinstall.bat 或 install.ps1。

Q：生产环境怎么部署？

A：README 列出了 Docker 方式，仓库内提供 docker/docker-compose.yml，推荐生产环境使用该文件部署。

Q：运行时数据存在哪里？

A：所有运行时状态都保存在 ~/.octop/ 目录下，可用 CLI 管理，也可直接编辑其中的文件。

注意事项

项目仍处早期阶段（0.9.34），安装方式与配置细节可能随版本变化。
安装后必须新开终端或重载 shell，否则 octop 命令可能不在 PATH 中。
README 节选未给出启动命令、端口与具体配置项，请以 ~/.octop/ 目录和官网 octop.cloud 为准。
一键安装脚本从远程 COS 地址下载，执行前请确认来源可信。

核心亮点

多用户与多智能体架构，支持团队独立配置和协作
本地优先设计，数据自主掌控，隐私安全有保障
内置长期记忆，能持续学习用户偏好，提升交互体验

不足之处

项目处于早期阶段，文档和社区生态尚待完善
多智能体协作的复杂场景可能带来较高的配置门槛

适用场景

团队内部部署私有 AI 助手，共享知识库并隔离用户数据
个人开发者自托管 AI 助手，实现个性化长期记忆的对话体验
对数据敏感的企业或机构，需要本地化 AI 服务而不依赖云端

替代项目

Open WebUI、LibreChat、Dify

项目介绍

Octop 是智能体领域的开源项目，由 TencentCloud 开发，是 2026 年新上线的项目。

在全站 13,014 个收录项目中，它的 GitHub 星标数（4,737）位列前 9%，在智能体分类的 2,499 个项目里位列前 10%。

近 45 天，它的 GitHub 星标从 997 增加到 4,737，净增 3,740。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。MIT许可证，可免费自托管部署，无付费版本。

它主要面向的使用场景是：团队内部部署私有AI助手，共享知识库并隔离用户数据。同类可对比的替代方案包括 Open WebUI、LibreChat、Dify。

上一篇：knowledge-agent-template

下一篇：awesome-openclaw