你们是怎么做到这么快发布的呢？

← 我们为此仓库建立了一个__社区驱动的开发团队__。快来加入我们吧！这里非常棒。

安装

前置条件

1. node.js 和 npm
2. 如果你还没有 pipx，请访问 这里
3. API密钥 (只需一个即可)
   • Anthropic
   • OpenAI

我们目前正在努力支持Windows！（如果你能帮忙，请告诉我们）

安装命令

使用 pipx + npm 进行安装：

# 第一步：确保 pipx 存储应用的目录已添加到你的 PATH 环境变量中
pipx ensurepath

# 第二步：安装后端
pipx install devon_agent

# 第三步：安装并运行主界面
npx devon-ui

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

就这样！祝你构建愉快 :)

运行代理

然后要运行主界面，命令如下：

npx devon-ui

就是这么简单。

终端界面

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

安装

1. 确保你已经安装了后端

# 对于后端
pipx install devon_agent

2. 安装终端用户界面

# 对于终端用户界面
npm install -g devon-tui

[!注意] 如果你已经安装了 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. 然后要运行终端界面，命令如下：

devon-tui

就这么简单。

[!注意] 不用担心，该代理只能访问它启动所在目录中的文件和文件夹。你也可以在它执行操作时进行修正。

---

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

devon-tui --debug

---

要在本地模式下运行：

[!警告] 目前对本地模型的支持尚不成熟，请谨慎使用，性能可能会比其他选项大幅下降。

1. 使用 ollama 启动 deepseek 模型

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

ollama run deepseek-coder:6.7b

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

devon-tui configure

配置 Devon CLI...
？选择模型名称：
  claude-opus 
  gpt4-o 
  llama-3-70b 
❯ ollama/deepseek-coder:6.7b

4. 最后，通过以下命令运行：

devon-tui --api_key=FOSS

---

要查看所有可用命令：

devon-tui --help

特性

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

局限性

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

进展

该项目仍处于非常早期阶段，我们非常希望得到你的帮助，让它变得更好！

当前目标

• 多模型支持
  • Claude 3.5 Sonnet
  • GPT4-o
  • Groq llama3-70b
  • Ollama deepseek-6.7b
  • Google Gemini 1.5 Pro
• 推出插件系统，供工具和智能体开发者使用
• 改进我们可自托管的 Electron 应用程序
• 在 SWE-bench Lite 上达到最先进水平

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

星标历史

过去的里程碑

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

[!注意] 如果你已经安装了 tui，请进行全新安装：

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

当前开发重点

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

我该如何贡献？

Devon 和 entropy-research 组织都是社区驱动的，我们欢迎所有人的参与！无论是解决问题、开发新功能，还是创建数据集，都有多种方式可以加入：

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

详情请查看 CONTRIBUTING.md。

如果你想为项目贡献力量，请加入我们的 Discord 社区：Discord

反馈

我们非常期待你的反馈！欢迎在我们的 Discord 服务器的 #feedback 频道中留言，或者直接 提交 issue！

我们收集基本的事件类型（如“工具调用”）和失败遥测数据，以帮助修复 bug 并提升用户体验。当然，如果你愿意主动联系我们，我们也非常乐意倾听你的意见！

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

export DEVON_TELEMETRY_DISABLED=true

社区

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

许可证

本项目采用 AGPL 许可证进行分发。更多信息请参阅 LICENSE 文件。

Devon 快速上手指南

Devon 是一款开源的 AI 结对编程助手，支持多文件编辑、代码库探索、测试生成及 Bug 修复等功能。它提供图形界面（Electron）和终端界面（TUI）两种使用方式。

环境准备

在开始之前，请确保您的系统满足以下要求：

• 操作系统：目前主要支持 macOS 和 Linux（Windows 支持正在开发中）。
• 运行时依赖：
  • Node.js 和 npm
  • pipx（用于隔离安装 Python 应用）
• API Key（任选其一即可）：
  • Anthropic API Key (推荐 Claude 3.5 Sonnet)
  • OpenAI API Key
  • Groq API Key (可选)

提示：如果您尚未安装 pipx，请参考 官方安装指南 进行安装。

安装步骤

Devon 由后端代理（Agent）和用户界面（UI）两部分组成。

1. 配置 pipx 路径

确保 pipx 的应用存储目录已添加到您的环境变量 PATH 中：

pipx ensurepath

2. 安装后端代理

使用 pipx 安装 Devon 后端：

pipx install devon_agent

(如果已安装过，可使用 pipx install --force devon_agent 强制更新)

3. 安装用户界面

根据您的偏好选择以下一种界面进行安装：

选项 A：图形界面 (推荐) 直接运行无需全局安装，或使用 npm 安装：

npx devon-ui

选项 B：终端界面 (TUI) 全局安装终端工具：

npm install -g devon-tui

(如果已安装，建议先卸载再重装以确保最新版本：npm uninstall -g devon-tui && npm install -g devon-tui)

基本使用

方式一：使用图形界面 (GUI)

这是最简单的启动方式，适用于大多数桌面开发场景。

1. 打开终端，进入您的项目根目录。
2. 设置您的 API Key 环境变量（以 Anthropic 为例）：

   export ANTHROPIC_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
   

   (或者使用 OPENAI_API_KEY)
3. 启动界面：

   npx devon-ui
   

4. 在弹出的窗口中输入自然语言指令，Devon 将自动分析代码库并执行修改。

方式二：使用终端界面 (TUI)

适合喜欢在命令行工作的开发者。

1. 打开终端，进入您的项目根目录。
2. 设置 API Key 环境变量：

   export ANTHROPIC_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
   

3. 启动终端助手：

   devon-tui
   

4. 在交互式终端中输入指令。您可以随时纠正 Agent 的操作，它仅能访问启动时所在目录及其子目录的文件。

高级用法：本地模型模式

如果您希望使用本地运行的模型（如通过 Ollama），请注意当前本地模式性能尚不成熟，仅供测试。

1. 启动本地模型（例如 DeepSeek Coder）：

   ollama run deepseek-coder:6.7b
   

2. 配置 Devon 使用该模型：

   devon-tui configure
   

   在提示中选择 ollama/deepseek-coder:6.7b。
3. 使用免费模式启动：

   devon-tui --api_key=FOSS
   

注意：Devon 默认会收集基本的遥测数据以改进产品。如需禁用，请在运行前设置：

export DEVON_TELEMETRY_DISABLED=true