Devon

环境要求

• Python 环境，并使用 pipx 安装后端 devon_agent
• Node.js / npm 环境（用于 npx 运行主 UI）
• Anthropic、OpenAI 或 Groq 其中之一的 API Key（本地模型模式可免）
• 若使用本地模型，需安装 ollama 并拉取 deepseek-coder:6.7b
• 在需要协作的项目文件夹中打开终端后运行

安装与启动步骤

1. 1安装后端

   用 pipx 安装 Devon 后端 devon_agent，这是主 UI 与终端 UI 运行的基础。若已安装，改用 --force 参数覆盖更新。

   pipx install devon_agent

   复制

2. 2更新后端(已装过)

   如果机器上已经有 devon_agent，用 --force 强制重新安装即可升级到最新版本。

   pipx install --force devon_agent

   复制

3. 3启动主界面

   通过 npx 拉取并运行 devon-ui 主界面，无需提前在本地安装前端依赖。

   npx devon-ui

   复制

4. 4设置模型密钥

   按你使用的模型服务，把对应 API Key 导出为环境变量；三者按需选其一即可。

   export ANTHROPIC_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
   export OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
   export GROQ_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

   复制

5. 5运行终端 UI

   在项目目录下执行 devon-tui 启动终端交互界面，Devon 只能访问你启动它的那个目录。

   devon-tui

   复制

6. 6调试模式运行

   排查问题时加上 --debug 参数启动终端 UI，可看到更详细的执行过程。

   devon-tui --debug

   复制

7. 7拉起本地模型

   用 ollama 启动 deepseek-coder:6.7b 本地服务，作为不依赖云 API 的备选方案。

   ollama run deepseek-coder:6.7b

   复制

8. 8切到本地模型

   先执行 configure 在交互列表中选择 ollama/deepseek-coder:6.7b，再用 FOSS 作为 api_key 运行。

   devon-tui configure
   devon-tui --api_key=FOSS

   复制

关键配置

如何确认成功

执行 devon-tui 后能进入终端交互界面，或运行 devon-tui --help 能列出全部可用命令，即表示安装配置成功。

常见问题

注意事项

• 请先进入你的项目文件夹再打开终端，Devon 的访问范围被限制在该目录内
• 主 UI 通过 npx 实时拉取，需要本机具备 Node.js/npm 环境
• 配置 API Key 时用 export 只对当前终端会话生效，重开终端需重新设置
• 本地模型模式性能会明显下降，仅建议在无网络或数据敏感场景下尝试