项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 11808
技术标签
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- 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 用 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
同类项目推荐
mcp-shrimp-task-manager
开源
把 AI 变成资深工程师,自动拆解任务并持续反思优化。
Shrimp Task Manager is a task tool built for AI Agents, emphasizing chain-of-thought···
legal-ai-agent
开源
用 AI 智能体快速解答法律问题,自动检索案例与法规
sivalabs-agent-skills
开源
让 AI 编码助手更懂 Spring Boot,生成规范代码
Spring Boot skills for AI coding agents
skills
开源
让 AI 编程助手自动遵循 FSD 架构规范,告别代码风格混乱
AI agent skills for applying Feature-Sliced Design (FSD) v2.1 in frontend projects.
iosm-cli
开源
在终端里用 IOSM 方法论,让 AI 编码更可控、可回滚
AI Engineering Runtime for Professional Developers — terminal coding agent with IOS···
claude-harness
开源
拆解 Claude Code 源码,搞懂 AI 编程代理内部机制
Deconstructing Claude Code — interactive source code analysis, guided wc/helpe walk···
Herald-OS
开源
让智能体当系统主界面,用说话代替点鼠标
An agent-native operating system, with Hermes Agent as the interface. Independent pr···
agentctx
开源
给 AI 编程智能体管好项目上下文,改了什么都能查
Lifecycle-managed, auditable project context for AI coding agents
agent-me
开源
把你的知识记忆蒸馏成可检查的 AI 分身
Distill your knowledge, memories, and decisions into an open-source, inspectable AI ···
