
Devon
像有位资深工程师 24 小时陪写代码,卡壳随时问。
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 3449
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Python 环境,并使用 pipx 安装后端 devon_agent
- Node.js / npm 环境(用于 npx 运行主 UI)
- Anthropic、OpenAI 或 Groq 其中之一的 API Key(本地模型模式可免)
- 若使用本地模型,需安装 ollama 并拉取 deepseek-coder:6.7b
- 在需要协作的项目文件夹中打开终端后运行
安装与启动步骤
-
1安装后端
用 pipx 安装 Devon 后端 devon_agent,这是主 UI 与终端 UI 运行的基础。若已安装,改用 --force 参数覆盖更新。
pipx install devon_agent -
2更新后端(已装过)
如果机器上已经有 devon_agent,用 --force 强制重新安装即可升级到最新版本。
pipx install --force devon_agent -
3启动主界面
通过 npx 拉取并运行 devon-ui 主界面,无需提前在本地安装前端依赖。
npx devon-ui -
4设置模型密钥
按你使用的模型服务,把对应 API Key 导出为环境变量;三者按需选其一即可。
export ANTHROPIC_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx export OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx export GROQ_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx -
5运行终端 UI
在项目目录下执行 devon-tui 启动终端交互界面,Devon 只能访问你启动它的那个目录。
devon-tui -
6调试模式运行
排查问题时加上 --debug 参数启动终端 UI,可看到更详细的执行过程。
devon-tui --debug -
7拉起本地模型
用 ollama 启动 deepseek-coder:6.7b 本地服务,作为不依赖云 API 的备选方案。
ollama run deepseek-coder:6.7b -
8切到本地模型
先执行 configure 在交互列表中选择 ollama/deepseek-coder:6.7b,再用 FOSS 作为 api_key 运行。
devon-tui configure devon-tui --api_key=FOSS
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
ANTHROPIC_API_KEY | 否 | 使用 Anthropic Claude 模型时的密钥,三选一 | sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
OPENAI_API_KEY | 否 | 使用 OpenAI GPT 系列模型时的密钥,三选一 | sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
GROQ_API_KEY | 否 | 使用 Groq 服务模型时的密钥,三选一 | sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
如何确认成功
执行 devon-tui 后能进入终端交互界面,或运行 devon-tui --help 能列出全部可用命令,即表示安装配置成功。
常见问题
Q:已经装过 devon_agent,怎么更新?
A:直接运行 pipx install --force devon_agent 强制重装即可完成更新,无需先卸载。
Q:Devon 会不会乱改我电脑里的其他文件?
A:不会。它只能访问你启动它时所在目录下的文件和文件夹,而且执行动作过程中你可以随时纠正它。
Q:本地 ollama 模型的体验和云模型一样吗?
A:不一样。README 明确提示本地模型支持尚不成熟,性能相比云模型会明显下降,请谨慎使用。
Q:怎么查看 Devon 支持的全部命令?
A:运行 devon-tui --help 即可列出所有可用命令和参数。
注意事项
- 请先进入你的项目文件夹再打开终端,Devon 的访问范围被限制在该目录内
- 主 UI 通过 npx 实时拉取,需要本机具备 Node.js/npm 环境
- 配置 API Key 时用 export 只对当前终端会话生效,重开终端需重新设置
- 本地模型模式性能会明显下降,仅建议在无网络或数据敏感场景下尝试
核心亮点
- 基于Python的AI结对编程工具,支持多文件代码库的上下文理解与修改,提升开发效率
- 开源且技术栈聚焦agent框架,便于开发者二次定制和集成到现有工作流
- 项目处于成长阶段,社区活跃度较高,便于获取反馈和贡献
不足之处
- 项目较新,文档和社区生态尚待完善,实际生产环境稳定性需观察
- 功能覆盖可能不及成熟商业工具,对复杂项目支持有限
适用场景
- 个人开发者日常编码辅助,快速生成和修改代码
- 小型团队内部代码审查与自动化补全
- 研究AI agent在编程场景的应用,作为实验平台
替代项目
Aider、Continue、OpenHands
同类项目推荐
nvim-aibo
开源
在 Neovim 里统一调度多个 AI 编程助手,告别切换工具
Aibo - AI Bot Integration and Orchestration for Neovim
token-saver
开源
压缩CLI输出60-99%,让AI编程助手少烧token
Content-aware output compression for AI coding assistants. 36 specialized processors···
harness-score
开源
几秒测出你的 AI 编程助手工具链成熟度
Your AI coding agent is only as reliable as the harness around it. Measure that harn···
gentle-shell
开源
让 AI 代理按架构师规范写代码,测试审查全留痕
Gentle Shell is a Pi-native workspace for AI-assisted development, bringing parallel···
enola
开源
看懂代码架构,提前发现变更影响和架构问题
Understand, analyze, and govern software systems across repositories, languages, and···
crab-code
开源
用 Rust 重写 Claude Code,兼容工作流,任意 LLM 都能跑。
Open-source alternative to Claude Code, built from scratch in Rust. Agentic coding C···
aver
开源
让 AI 写的代码,每一行都能被审计和信任
Aver is a programming language for auditable AI-written code
claude-code-ultimate-guide
开源
学透Claude Code,从入门到生产级实战
The most comprehensive Claude Code guide: agentic workflows, hooks, skills, MCP serv···
OdinRunes
开源
在编辑器里直接调教 GPT,自动提取上下文,省心省钱。
Odin Runes, a java-based GPT client, facilitates interaction with your preferred GPT···