octop 可通过 pypi 一键安装，要求 python ≥3.12；支持 pip install octop 或带扩展的 pip install "octop[chroma]"，首次运行生成 ~/.octop/ 配置目录，启动命令为 octop console。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Octop 可通过 PyPI 一键安装，前提是系统满足最低要求：Python 版本需为 3.12 或更高版本。不兼容 Python 3.11 及以下版本。
安装前确认 Python 环境
在终端或命令行中运行：
-
python --version或python3 --version，确认输出类似Python 3.12.5 - 若未安装或版本过低，请先升级 Python（推荐使用 pyenv 或官方安装包）
- 建议使用独立虚拟环境，避免依赖冲突：
python -m venv octop-env && source octop-env/bin/activate（Linux/macOS）
Windows 用户用：python -m venv octop-env && octop-env\Scripts\activate
执行 PyPI 安装命令
确保网络通畅（国内用户建议配置 pip 镜像源以加速）：
- 基础安装：
pip install octop - 如需支持中文 RAG 或向量检索（例如搭配 ChromaDB），可加 extras：
pip install "octop[chroma]" - 安装完成后验证：
octop --version应输出类似octop 0.3.0
启动与首次运行
安装成功后，直接运行控制台模式：
-
octop console—— 启动交互式 AI 助手界面 - 首次运行会自动生成配置目录
~/.octop/，含用户数据、记忆库和多智能体定义 - 如需启用多用户或 IM 接入（如微信、飞书），需手动编辑
~/.octop/config.yaml并重启服务
常见问题提示
若安装时遇到 check_hostname requires server_hostname 类 SSL 错误（多见于旧版 pip 或代理环境）：
- 先升级 pip：
pip install --upgrade pip - 临时跳过 SSL 验证（仅调试用）：
pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org octop - 更稳妥的方式是配置国内镜像源，例如清华源：
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ octop
