evo.ninja 开源项目使用教程

evo.ninja 开源项目使用教程

evo.ninja 项目地址: https://gitcode.com/gh_mirrors/ev/evo.ninja

1、项目介绍

evo.ninja 是一个多功能通用代理（agent），能够根据任务需求实时调整自身行为。它利用预定义的代理角色（agent personas）来适应不同领域的任务。每个执行循环中，evo.ninja 会选择最适合当前任务的角色，并根据上下文信息进行评估和执行。

evo.ninja 的核心功能包括：

• 实时适应性：根据任务需求动态调整行为。
• 预定义角色：提供多种角色，如文本分析、CSV 数据处理、网络研究和软件开发等。
• 执行循环：通过预测、选择角色、上下文化和评估执行四个步骤，持续迭代以实现用户目标。

2、项目快速启动

安装依赖

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

• git
• nodejs
• yarn
• nvm

安装步骤

1. 克隆仓库：

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

2. 配置环境变量：

   cp .env.template .env
   

   打开 .env 文件，添加你的 OpenAI API Key 和 SERP API Key：

   OPENAI_API_KEY=sk-...
   SERP_API_KEY=b071...
   

3. 安装 Node.js 版本：

   nvm install && nvm use
   

4. 安装 Yarn：

   npm install -g yarn
   

5. 安装依赖并构建项目：

   yarn && yarn build
   

运行项目

通过 CLI 运行 evo.ninja：

yarn start [goal]

可选参数：

• -s, --session <name>：指定会话名称。
• -t, --timeout <seconds>：设置超时时间。
• -d, --debug：启用调试日志。

3、应用案例和最佳实践

应用案例

1. 文本分析：

   • 使用 Synthesizer 角色分析文本文件，生成摘要和报告。

   yarn start "Analyze the text file and generate a summary"
   

2. CSV 数据处理：

   • 使用 Csv Analyst 角色处理 CSV 文件，提取关键数据点。

   yarn start "Extract key data points from the CSV file"
   

3. 网络研究：

   • 使用 Researcher 角色在互联网上搜索信息。

   yarn start "Search the internet for information about AI trends"
   

最佳实践

• 明确目标：在运行 evo.ninja 时，明确指定目标，以便代理选择合适的角色。
• 调试模式：使用 --debug 参数获取详细的调试日志，帮助排查问题。
• 会话管理：使用 --session 参数管理多个会话，方便跟踪不同任务的执行情况。

4、典型生态项目

evo.ninja 作为一个多功能通用代理，可以与其他开源项目结合使用，扩展其功能。以下是一些典型的生态项目：

1. OpenAI API：

   • 提供强大的自然语言处理能力，evo.ninja 利用 OpenAI API 进行文本分析和生成。

2. SERP API：

   • 用于网络搜索，evo.ninja 的 Researcher 角色依赖 SERP API 获取互联网上的信息。

3. Supabase：

   • 提供数据库和身份验证服务，evo.ninja 的 UI 依赖 Supabase 进行数据存储和管理。

通过结合这些生态项目，evo.ninja 可以实现更复杂和多样化的任务处理。

evo.ninja 项目地址: https://gitcode.com/gh_mirrors/ev/evo.ninja