evolver

环境要求

• Node.js >= 18
• npm（随 Node.js 一起安装）
• 任意一个已 git init 的项目目录（evolver 需在 git 仓库内运行）
• （可选）evomap.ai 账号与 Node ID，用于接入 A2A Hub

安装与启动步骤

1. 1全局安装 CLI

   用 npm 全局安装 @evomap/evolver，这是官方推荐的绝大多数人使用路径。

   npm install -g @evomap/evolver

   复制

2. 2验证安装

   执行 --help 确认 evolver 已在 PATH 中可用；若命令找不到说明全局 bin 目录未加入 PATH。

   evolver --help

   复制

3. 3加目标项目运行

   evolver 必须在已 git 初始化的目录内运行，否则不会输出 GEP prompt。把 /your/git-project 换成你自己的仓库路径。

   cd /your/git-project
   evolver

   复制

4. 4配置节点信息

   到 evomap.ai 注册并获取 Node ID，然后在项目 .env 文件中写入下面两行，即可对接 A2A Hub。

   A2A_HUB_URL=https://evomap.ai
   A2A_NODE_ID=your_node_id_here

   复制

5. 5接入编辑器钩子

   可选。按平台执行一次 setup-hooks，会写入对应配置与脚本；Cursor、Claude Code、Codex、opencode 需重启，Kiro 免重启。

   evolver setup-hooks --platform=cursor

   复制

6. 6后台循环运行

   可选。--loop 让 evolver 作为后台守护进程持续自维护，会按自适应间隔重复执行。

   evolver --loop

   复制

7. 7从源码运行

   仅贡献者需要。克隆仓库后安装依赖，之后用 node index.js 代替 evolver 命令，两者等价。

   git clone https://github.com/EvoMap/evolver.git
   cd evolver
   npm install

   复制

关键配置

如何确认成功

运行 evolver 后应看到含策略预设（如 balanced）的 banner、stdout 输出的 GEP prompt，并在 ./memory/ 写入 EvolutionEvent。

常见问题

注意事项

• Node.js 版本需 >= 18，安装前先确认本地版本。
• evolver 必须在 git-initialized 的目录中运行，否则不会产出 GEP prompt。
• 除 LLM 与 Hub 通信外，其余流程可完全离线运行；standalone 模式下输出的 sessions_spawn 只是文本，不会自动执行。
• cron 中建议只写 bash -lc 'evolver --loop' 这种简单命令，不要拼接多段 shell，避免嵌套引号被转义层破坏。