LibreAI / AI Agents / evolver
// agents · EvoMap/evolver

evolver

A GEP-powered self-evolving engine for AI agents — auditable evolution with Genes, Capsules and Events.

★ 9.1k stars⑂ 848 forksGPL-3.0updated 2026-09
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

evolver is an open-source ai agents project by EvoMap (EvoMap/evolver on GitHub). It has 9,138 GitHub stars and 848 forks, is released under the GPL-3.0 license, and was last updated on GitHub on 30 September 2026.

Repository
EvoMap/evolver
GitHub stars
9,138
Forks
848
License
GPL-3.0
Last updated on GitHub
30 September 2026
Category
AI Agents
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    Pick the git repo and agent whose logs and prompts you want to evolve, and decide whether evolution runs in review mode or as a background loop.

  2. Get the project

    Clone EvoMap/evolver from GitHub (or use the install path in the run steps below) and skim its README for the parts relevant to your goal.

  3. Install and configure

    Install the CLI globally from npm; Node.js 18+ and git are prerequisites, and no clone is needed unless you are contributing.

  4. Run your first task

    Run evolver once in the repo for a single evolution run, review the selected Gene and GEP prompt, then decide whether to enable the continuous loop.

// features

Why people love it

GEP evolution assets

Improvements are captured as Genes, Capsules and Events — auditable, reusable assets rather than one-off prompt edits.

Single-run or daemon

Run one evolution pass on demand, a review mode that waits for human confirmation, or a continuous background loop.

Git-native safety

Evolver uses git for rollback, blast-radius calculation and solidifying accepted changes, and refuses to run outside a git repo.

EvoMap network (optional)

Optionally register with the EvoMap evolution network to connect your node to the wider ecosystem.

Agent-runtime wiring

Optional integration points wire the evolved output back into your agent runtime.

Clear boundaries

The README is explicit about what Evolver does not do — it does not auto-edit your source code or execute arbitrary shell commands outside its security model.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Get the source from the official GitHub repository for evolver.

    git clone https://github.com/EvoMap/evolver.git
    cd evolver
  2. Install the CLI

    Install Evolver globally from npm as the README's 30-second quick start shows.

    npm install -g @evomap/evolver
  3. Run an evolution pass

    Run evolver inside any git repo to scan logs, select a Gene and output a GEP prompt; add a .env in that working directory if your setup needs one.

    evolver  # run inside your git repo — see README for review and loop modes
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains evolver?

EvoMap, through the EvoMap/evolver repository, with the network and wiki at evomap.ai.

Is evolver free to use?

Yes — the project is open source under the GPL-3.0 license as recorded for this listing. See the license terms for any conditions on redistribution.

Does evolver need a paid API key?

Evolver drives evolution using model access you configure in a .env in the working directory; the tool itself is open source, and any model cost is yours.

How does Evolver compare to manually tuning an agent's prompt?

Manual tuning is fast but unauditable and easy to lose. Evolver formalises the same loop into Genes, Capsules and Events with git rollback and review modes — more process, in exchange for a history you can inspect and revert.

How do I get started with evolver?

Clone the repository (or use the documented installer), follow the install and configure steps on this page, and run the smallest real task first — run evolver once in the repo for a single evolution run, review the selected Gene and GEP prompt, then decide whether to enable the continuous loop.

// keep exploring

Similar tools

AI Agents

EvoAgentX

EvoAgentX — a framework for building self-evolving ecosystems of AI agents.

★ 3.4k starsMIT
View guide →
AI Agents

reef

Reef — infrastructure for continually self-improving agents: weight-training and harness-evolving deployments.

★ 7.5k starsApache-2.0
View guide →
AI Agents

MemOS

Self-evolving memory OS for LLMs and agents: persistent graph memory, hybrid retrieval, skill reuse.

★ 11.8k starsApache-2.0
View guide →
AI Agents

khoj

Your self-hostable AI second brain for answers, agents, and automations.

★ 37.6k starsAGPL-3.0
View guide →
AI Agents

SimWorld

SimWorld: an Unreal Engine 5 simulator for evaluating LLM/VLM agents in physical and social worlds.

★ 793 starsApache-2.0
View guide →
AI Agents

ActPlane

eBPF-powered information-flow enforcement for safer AI agents.

★ 104 starsMIT
View guide →
// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if evolver is not the right fit.

Get evolver

Free and open — grab the source, star the repo, and start creating.