快速开始

一键环境安装

自动检测系统环境，安装 Python 3.11+、Node.js 20+，创建虚拟环境，安装全部依赖并运行 5 项验证。

git clone https://github.com/octopusos/octopus.git
cd octopus
chmod +x scripts/setup-macos.sh
./scripts/setup-macos.sh

git clone https://github.com/octopusos/octopus.git
cd octopus
chmod +x scripts/setup-linux.sh
sudo ./scripts/setup-linux.sh

git clone https://github.com/octopusos/octopus.git
cd octopus

# PowerShell (Administrator)
Set-ExecutionPolicy -Scope Process Bypass
.\scripts\setup-windows.ps1

脚本自动完成

• Python 3.11+ (Homebrew / apt / winget)
• Node.js 20 LTS
• 虚拟环境 .venv/ 创建与激活
• kernel / server / CLI / TUI 四层 pip install
• Web 前端 npm install
• 5 项自动验证（Server / CLI / TUI / Web / 3,534 Kernel Tests）

启动服务

source .venv/bin/activate
python3 -m server.main

# 验证
curl http://localhost:8000/health
# {"status": "ok"}

体验三种产品形态

# CLI 交互
source .venv/bin/activate
PYTHONPATH=products python3 -m cli
PYTHONPATH=products python3 -m cli chat

# TUI 终端界面
PYTHONPATH=products python3 -m tui

# Web 控制台
cd products/web && npm run dev
# 浏览器打开 http://localhost:5173

安装验证

安装脚本自动运行以下 5 项验证：

• Server 应用创建 — FastAPI app 正常初始化
• CLI 版本输出 — octopus 0.9.0
• TUI 导入检查 — textual 组件加载成功
• Web 构建 — Vite 生产构建通过
• Kernel 测试 — 3,534 测试全部通过