Octop

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

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 智能体 🍴 复刻 1632 🐛 待处理 757 👀 关注 67
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 11808
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源项目,MIT许可证,可免费自托管部署,无付费版本。

项目预览

Octop 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类智能体
开发团队TencentCloud
定价模式🏷️完全免费
价格说明开源项目,MIT许可证,可免费自托管部署,无付费版本。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Python
技术栈/模型agent,agentic-ai,ai,ai-agent,ai-agents,local-first,long-term-memory
GitHub 星标★ 11808
上线时间2026-07-08 00:00:00
代码更新2026-11-09
仓库体积43.4 MB
本站数据更新2026-11-09
维护状态活跃
收录时间2026-08-09
浏览次数5

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 11808

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

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

环境要求

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

安装与启动步骤

  1. 1macOS/Linux 一键安装

    官方推荐方式,脚本自动在 ~/.octop/venv 创建隔离环境,不会改动系统 Python。

    curl -fsSL https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.sh | bash
  2. 2Windows PowerShell 安

    在 PowerShell 中执行官方远程安装脚本;安装完成后同样会生成 octop 入口。

    irm https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.ps1 | iex
  3. 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. 4重载 shell 环境

    README 要求安装后打开新终端或重载 shell,让 ~/.octop/bin 下的命令生效(示例为 Zsh)。

    source ~/.zshrc
  5. 5可选:浏览器能力

    需要浏览器相关扩展能力时安装该可选依赖,README 标注为 optional。

    pip install "octop[browser]"
  6. 6可选:本地嵌入模型

    可选安装本地 ONNX embedding 模型缓存,对应界面中的 Models → Local。

    pip install "octop[local-embedding]"
  7. 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 用 scripts\install.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

上一篇:knowledge-agent-template

下一篇:awesome-openclaw

同类项目推荐

mcp-shrimp-task-manager 开源

把 AI 变成资深工程师,自动拆解任务并持续反思优化。

Shrimp Task Manager is a task tool built for AI Agents, emphasizing chain-of-thought···

★ 2150 2026-08-09
skills 开源

让 AI 编程助手自动遵循 FSD 架构规范,告别代码风格混乱

AI agent skills for applying Feature-Sliced Design (FSD) v2.1 in frontend projects.

★ 117 2026-08-09
iosm-cli 开源

在终端里用 IOSM 方法论,让 AI 编码更可控、可回滚

AI Engineering Runtime for Professional Developers — terminal coding agent with IOS···

★ 143 2026-08-09
claude-harness 开源

拆解 Claude Code 源码,搞懂 AI 编程代理内部机制

Deconstructing Claude Code — interactive source code analysis, guided wc/helpe walk···

★ 118 2026-08-09
Herald-OS 开源

让智能体当系统主界面,用说话代替点鼠标

An agent-native operating system, with Hermes Agent as the interface. Independent pr···

★ 631 2026-10-19
agentctx 开源

给 AI 编程智能体管好项目上下文,改了什么都能查

Lifecycle-managed, auditable project context for AI coding agents

★ 291 2026-10-30
agent-me 开源

把你的知识记忆蒸馏成可检查的 AI 分身

Distill your knowledge, memories, and decisions into an open-source, inspectable AI ···

★ 629 2026-09-12