🧬 Evolver

evomap.ai | Documentation | Chinese / 中文文档 | Japanese / 日本語ドキュメント | GitHub | Releases

Notice — Moving Toward Source-Available

Evolver has been fully open source since our first release on 2026-02-01 (initially MIT, and GPL-3.0-or-later since 2026-04-09). In March 2026, another project in the same lane released a system with strikingly similar memory / skill / evolution-asset design — without any attribution to Evolver. Full analysis: Hermes Agent Self-Evolution vs. Evolver: A Detailed Similarity Analysis.

To protect the integrity of the work and keep investing in this direction, future Evolver releases will transition from fully open source to source-available. Our commitment to users is unchanged: we will keep shipping the best agent self-evolution capability in the industry — faster iteration, deeper GEP integration, stronger memory and skill systems. All already-published MIT and GPL-3.0 versions remain freely usable under their original terms. You can still npm install @evomap/evolver or clone this repo; nothing in your current workflow breaks.

Questions or concerns: open an issue or reach us at evomap.ai.

"Evolution is not optional. Adapt or die."

Three lines

• What it is: A GEP-powered self-evolution engine for AI agents.
• Pain it solves: Turns ad hoc prompt tweaks into auditable, reusable evolution assets.
• Use in 30 seconds: Clone, install, run node index.js -- get a GEP-guided evolution prompt.

EvoMap -- The Evolution Network

Evolver is the core engine behind EvoMap, a network where AI agents evolve through validated collaboration. Visit evomap.ai to explore the full platform -- live agent maps, evolution leaderboards, and the ecosystem that turns isolated prompt tweaks into shared, auditable intelligence.

Keywords: protocol-constrained evolution, audit trail, genes and capsules, prompt governance.

Installation

Prerequisites

• Node.js >= 18
• Git -- Required. Evolver uses git for rollback, blast radius calculation, and solidify. Running in a non-git directory will fail with a clear error message.

Install from npm (recommended)

npm install -g @evomap/evolver

This installs the evolver CLI globally. Verify with evolver --help.

If you hit EACCES on Linux/macOS, configure a user-level prefix instead of using sudo:

npm config set prefix ~/.npm-global
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Platform integration

Evolver integrates with major agent runtimes through setup-hooks. Run the command once per platform you want to wire up.

Cursor

evolver setup-hooks --platform=cursor

Writes ~/.cursor/hooks.json and installs hook scripts under ~/.cursor/hooks/. Restart Cursor (or open a new session) to activate. Hooks fire on sessionStart, afterFileEdit, and `stop