evo.ninja

Discord | 给仓库点个 :star: ！

欢迎！

要开始使用evo.ninja，只需前往我们的网站，或者按照以下设置说明从源代码构建和运行。

需要帮助？

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

如果您有疑问或遇到问题，请随时创建新的issue以获得支持。

工作原理

evo.ninja的特别之处在于它能根据当前任务实时调整自身。Evo利用预定义的代理人物角色，这些角色针对特定任务领域进行了定制。在每次执行循环中，evo都会选择并采用最适合当前任务的角色。

代理人物角色

代理	专长
📝综合分析器	"阅读文本文件，分析和收集文本文件中的数据和信息，生成摘要和报告，并分析文本。"
#️⃣ CSV分析师	"擅长读取CSV文件，搜索数据，提取关键数据点，计算金额，并从CSV文件中得出见解。"
🌐 研究员	"搜索互联网，理解细节，查找信息。"
💻 开发人员	"设计和构建复杂软件。专精于Python。"

执行循环

预测下一步： 在每次执行循环中，Evo首先对最佳下一步做出明智预测。
选择最佳代理： 根据这个预测，Evo选择最适合的代理人物角色。
上下文化聊天历史： 基于步骤1的预测和步骤2的代理人物角色，完整的聊天历史被"上下文化"，只有最相关的消息被用于最终评估步骤。
评估和执行： 进行最后的评估步骤，以确定执行哪个代理功能来尝试进一步实现用户的目标。

这4个步骤在循环中持续运行，直到确定用户的目标已经实现。

设置

前提条件

请安装以下内容：

安装

克隆仓库

git clone https://github.com/agentcoinorg/evo.ninja
复制.env.template文件并将其重命名为.env。

cp .env.template .env
找到写有OPENAI_API_KEY=的行，添加您的唯一OpenAI API密钥 OPENAI_API_KEY=sk-...
找到写有SERP_API_KEY=的行，添加您的唯一SERP API密钥。 SERP_API_KEY=b071...（参见 https://serpapi.com）
使用正确版本的Node.JS

nvm install && nvm use 如果node环境是新的，安装Yarn npm install -g yarn
安装所有依赖项并构建项目

yarn && yarn build

现在您已准备就绪！您可以通过CLI或使用UI运行Evo

CLI

在终端中运行evo：

yarn start

参数：

[goal] - 要实现的目标

选项：

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

会话工作空间

运行evo.ninja CLI后，将创建一个./sessions目录，其中包含命名的会话。这是代理的根目录，代理只会读取和写入此目录中的文件。每个会话工作空间中都有一个.evo/目录，用于保存内部日志，包括一个chat.md文件，提供代理输出的markdown版本。使用--debug可以在此处获得原始调试日志。

UI

UI依赖于Supabase数据库。为了在本地运行，您必须安装并运行Docker Desktop。

确保您已完成上述安装步骤
进入cd apps/browser
运行yarn db:start - 这可能需要长达约3分钟的时间，因为它将下载supabase所需的所有镜像
使用步骤2输出中显示的值更新.env.local：
- NEXT_PUBLIC_SUPABASE_URL将使用API URL的值
- SUPABASE_SERVICE_ROLE_KEY将使用service_role key的值
使用yarn dev运行UI