---

Discord | 为这个仓库点赞！

---

欢迎！

要开始使用 evo.ninja，只需访问我们的网站，或者按照这些设置说明从源代码构建并运行。

需要帮助吗？

加入我们的Discord 社区，获取支持和参与讨论。

如果您有任何问题或遇到困难，请随时创建新 issue 以获得支持。

工作原理

evo.ninja 的特别之处在于，它能够根据当前的任务实时调整自身行为。evo 使用预定义的代理角色，这些角色针对特定领域的任务进行了优化。在每次执行循环中，evo 都会根据当前任务选择最合适的代理角色来完成目标。

代理角色

代理	专长
📝合成器	“读取文本文件，分析并收集其中的数据和信息，生成摘要和报告，并对文本进行分析。”
#️⃣ CSV 分析师	“擅长读取 CSV 文件，搜索数据、提取关键点、计算数值，并从 CSV 文件中得出洞察。”
🌐 研究员	“在互联网上搜索、理解细节并查找信息。”
💻 开发者	“架构并构建复杂软件，专注于 Python。”

执行循环

1. 预测下一步： 在每次执行循环中，evo 首先会基于现有信息做出关于最佳下一步的判断。
2. 选择最佳代理： 根据这一判断，evo 会选择一个最适合当前任务的代理角色。
3. 上下文化聊天记录： 基于第一步的预测和第二步选定的代理角色，整个聊天记录会被“上下文化”，只保留最相关的信息用于最后的评估步骤。
4. 评估与执行： 最后一步会对当前情况做最终评估，以确定应调用哪个代理功能来进一步实现用户的目标。

这四个步骤会不断循环执行，直到确认用户的任务已经完成为止。

设置

先决条件

请安装以下工具：

• git
• Node.js
• Yarn
• nvm

安装

1. 克隆仓库

   git clone https://github.com/agentcoinorg/evo.ninja

2. 复制 .env.template 文件并重命名为 .env。

   cp .env.template .env

3. 找到包含 OPENAI_API_KEY= 的行，填入您唯一的 OpenAI API 密钥。
   OPENAI_API_KEY=sk-...
4. 找到包含 SERP_API_KEY= 的行，填入您的唯一 SERP API 密钥。
   SERP_API_KEY=b071...（详情请参见 https://serpapi.com）
5. 使用正确的 Node.js 版本

   nvm install && nvm use 如果是全新的 Node.js 环境，请安装 Yarn：
   npm install -g yarn

6. 安装所有依赖并构建项目

   yarn && yarn build

现在您已经准备就绪！可以通过命令行界面或用户界面运行 evo。

命令行界面

在终端中运行 evo：

yarn start

参数：

• [goal] - 要达成的目标

选项：

• -s, --session <name> - ./sessions/... 目录下的会话名称。
• -t, --timeout <seconds> - 设置超时时间，超过指定秒数后将终止进程。
• -d, --debug - 在 ./sessions/${session}/.evo/... 目录下输出调试日志。

会话工作区

当 evo.ninja 命令行界面启动后，会创建一个 ./sessions 目录，其中包含多个命名会话。这是代理的根目录，代理只会读写该目录内的文件。每个会话工作区中都会有一个 .evo/ 目录，用于存放内部日志，其中包括一个 chat.md 文件，提供代理输出的 Markdown 格式版本。使用 --debug 选项可以在该目录中获取原始的调试日志。

用户界面

UI 依赖于 Supabase 数据库。要在本地运行 UI，您需要安装并运行 Docker Desktop。

0. 确保您已按照上述安装步骤操作。
1. 进入 cd apps/browser。
2. 运行 yarn db:start - 这可能需要大约 3 分钟，因为系统会下载 Supabase 所需的所有镜像。
3. 根据第 2 步的输出更新 .env.local 文件中的值：
   • NEXT_PUBLIC_SUPABASE_URL 将显示为 API URL。
   • SUPABASE_SERVICE_ROLE_KEY 将显示为 service_role key。
4. 运行 UI：

   yarn dev

evo.ninja 快速上手指南

evo.ninja 是一款能够根据任务实时自适应的 AI 代理工具。它内置了多种专家角色（如研究员、开发者、数据分析师等），通过动态选择最合适的角色来执行复杂任务。

环境准备

在开始之前，请确保您的系统已安装以下依赖：

• Git: 版本控制工具
• Node.js: 运行时环境（建议使用 nvm 管理版本）
• Yarn: 包管理器
• NVM: Node 版本管理工具

国内加速建议：

• 安装 Node.js 和 Yarn 时，如遇下载缓慢，可配置淘宝镜像源：

  npm config set registry https://registry.npmmirror.com
  yarn config set registry https://registry.npmmirror.com
  

安装步骤

1. 克隆项目仓库

   git clone https://github.com/agentcoinorg/evo.ninja
   cd evo.ninja
   

2. 配置环境变量 复制模板文件并重命名：

   cp .env.template .env
   

   编辑 .env 文件，填入您的 API Key：

   • OPENAI_API_KEY: 填入您的 OpenAI API Key (格式：sk-...)
   • SERP_API_KEY: 填入您的 SerpApi Key (用于联网搜索，获取地址：https://serpapi.com)

3. 设置 Node 版本并安装依赖 使用项目指定的 Node 版本并安装全局 Yarn（如果是新环境）：

   nvm install && nvm use
   npm install -g yarn
   

   安装项目依赖并构建：

   yarn && yarn build
   

基本使用

安装完成后，您可以通过命令行（CLI）或网页界面（UI）运行 evo.ninja。

方式一：命令行运行 (推荐快速测试)

在终端直接运行以下命令启动代理，并将 [您的目标] 替换为您想要完成的任务描述：

yarn start "[您的目标]"

常用参数示例：

• 指定会话名称（便于后续查看记录）：

  yarn start "分析销售数据" -s sales-analysis
  

• 设置超时时间（秒）：

  yarn start "编写一个爬虫脚本" -t 300
  

• 开启调试模式（生成详细日志）：

  yarn start "修复代码错误" -d
  

说明：运行后会在 ./sessions 目录下生成会话文件夹，其中包含代理生成的文件和 chat.md 执行记录。

方式二：网页界面运行

如果您需要图形化界面，需先启动本地数据库（依赖 Docker）：

1. 进入浏览器应用目录：

   cd apps/browser
   

2. 启动本地 Supabase 数据库（首次运行需下载镜像，约需 3 分钟）：

   yarn db:start
   

3. 根据上一步输出的信息，更新 apps/browser/.env.local 文件：
   • 将输出中的 API URL 填入 NEXT_PUBLIC_SUPABASE_URL
   • 将输出中的 service_role key 填入 SUPABASE_SERVICE_ROLE_KEY
4. 启动开发服务器：

   yarn dev
   

   启动成功后，在浏览器访问显示的本地地址即可使用。