https://github.com/entropy-research/Devon/assets/61808204/f3197a56-3d6d-479f-bc0e-9cffe69f159b

你们怎么发布得这么快？

← 我们有一个 社区驱动的开发团队 来维护这个仓库。快来加入我们吧！非常棒。

安装

先决条件

1. node.js 和 npm
2. pipx，如果没有请前往这里安装
3. API 密钥 (只需一个)
   - Anthropic
   • OpenAI

我们正在努力支持 Windows 系统！（如果你能提供帮助，请告诉我们）

安装命令

使用 pipx + npm 安装：

# 步骤 1：确保 pipx 存储应用程序的目录在你的 PATH 环境变量中
pipx ensurepath

# 步骤 2：安装后端
pipx install devon_agent

# 步骤 3：安装并运行主 UI
npx devon-ui

如果已经安装了 devon_agent，可以通过以下命令更新：
pipx install --force devon_agent

就这么简单！祝您编码愉快 :)

运行助手

要运行主 UI，命令是：

npx devon-ui

就这么简单。

终端 UI

如果你想使用终端界面，请按照以下步骤操作：

安装

1. 确保已安装后端

# 安装后端
pipx install devon_agent

2. 安装终端 UI

# 安装终端 UI
npm install -g devon-tui

[!NOTE]
如果已经安装了 devon-tui，可以通过以下命令更新：

npm uninstall -g devon-tui
npm install -g devon-tui

运行

1. 导航到你的项目文件夹并打开终端。
2. 将你的 Anthropic API 或 OpenAI API 密钥设置为环境变量：

export ANTHROPIC_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# 或者

export OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# 或者

export GROQ_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

3. 然后运行终端 UI 的命令是：

devon-tui

就这么简单。

[!NOTE]
别担心，助手只能访问你启动它的目录下的文件和文件夹。你还可以在它执行操作时进行纠正。

要在调试模式下运行，命令是：

devon-tui --debug

要在本地模式下运行：

[!WARNING]
当前版本的本地模型支持尚不成熟，请谨慎操作，并预期其性能将显著低于其他选项。

1. 使用 ollama 运行 deepseek 模型

2. 通过以下命令启动本地 ollama 服务器

ollama run deepseek-coder:6.7b

4. 然后配置 devon 使用该模型

devon-tui configure

Configuring Devon CLI...
? Select the model name: 
  claude-opus 
  gpt4-o 
  llama-3-70b 
❯ ollama/deepseek-coder:6.7b

4. 最后，使用以下命令运行：

devon-tui --api_key=FOSS

查看所有可用命令列表：

devon-tui --help

功能特性

• 多文件编辑
• 代码库探索
• 配置文件编写
• 测试编写
• 错误修复
• 架构探索
• 本地模型支持

局限性

• 对非 Python 语言的功能支持有限
• 有时需要指定要更改的文件
• 本地模式目前效果不佳。请尽量避免使用。

项目进展

这个项目仍处于非常早期的阶段，我们非常需要你的帮助来让它变得更好！

当前目标

• 多模型支持
• [x] Claude 3.5 Sonnet
• [x] GPT4-o
• [x] Groq llama3-70b
• [x] Ollama deepseek-6.7b
• [ ] Google Gemini 1.5 Pro
• 为工具和智能体构建者启动插件系统
• 改进我们可自托管的 Electron 应用
• 在 SWE-bench Lite 上达到 SOTA 水平

查看我们关于下一步计划的当前想法 请点击这里

星标历史

过往里程碑

• [x] 2024年6月28日 - 文件和代码引用，提高可操控性，支持 Claude Sonnet v0.0.16
• [x] 2024年6月14日 - 发布 Electron UI v0.0.13
• [x] 2024年6月1日 - Devon V2 Beta Electron UI
• [x] 2024年5月19日 - GPT4o 支持 + 更好的界面支持 v0.1.7
• [x] 2024年5月12日 - 完成交互式智能体 v0.1.0
• [x] 2024年5月10日 - 添加可操控性功能
• [x] 2024年5月8日 - 在 SWE-Bench Lite 上击败 AutoCodeRover
• [x] 2024年4月中旬 - 添加仓库级代码搜索工具
• [x] 2024年4月2日 - 开始开发 v0.1.0 交互式智能体
• [x] 2024年3月17日 - 发布非交互式智能体 v0.0.1

[!NOTE]
如果已经安装了终端 UI，请运行一次干净的重新安装：

npm uninstall -g devon-tui
npm install -g devon-tui

当前开发重点

1. 改进上下文收集和代码索引能力，例如：
   • 添加内存模块
   • 改进代码索引
2. 添加替代模型和智能体，以：
   • a) 降低最终用户成本
   • b) 降低最终用户延迟
3. Electron 应用
   • 保存和加载项目概览以供智能体上下文使用
   • 还原和“回退”时间线界面
   • 更好的代码差异视图
   • 将用户文件事件/更改发送给 Devon

如何贡献？

Devon 和 entropy-research 组织是社区驱动的，我们欢迎所有人的贡献！
从解决问题到构建功能再到创建数据集，有很多方式可以参与进来：

• 核心功能： 帮助我们开发核心智能体、用户体验、工具集成、插件等。
• 研究： 帮助我们研究智能体性能（包括基准测试！）、构建数据管道以及微调模型。
• 反馈与测试： 使用 Devon，报告错误，建议功能，或提供可用性反馈。

详情请查看 CONTRIBUTING.md。

如果你想为项目做贡献，请加入我们的 Discord：Discord

反馈

我们非常欢迎反馈！欢迎在我们的 Discord 的 #feedback 频道留言，或者创建问题！

我们收集基本的事件类型（例如“工具调用”）和故障遥测数据，以解决错误并改善用户体验。如果你想联系我们，我们非常乐意听取你的意见！

要禁用遥测，请将环境变量 DEVON_TELEMETRY_DISABLED 设置为 true

export DEVON_TELEMETRY_DISABLED=true

社区

加入我们的 Discord 服务器，打个招呼吧！
Discord

许可证

根据 AGPL 许可证分发。有关更多信息，请参阅 LICENSE。