← all repositories
gepa-ai/gepa

Evolutionary optimization that actually reads the error logs

GEPA is an evolutionary search framework that uses an LLM to read execution traces—errors, logs, profiler output—and write targeted mutations, optimizing any measurable text artifact from prompts to agent architectures.

5.7k stars Jupyter Notebook LLMOps · EvalAgents
gepa
Velocity · 7d
+9.1
★ / day
Trend
cooling
star history

What it does GEPA (Genetic-Pareto) treats any measurable text artifact—system prompts, code, agent architectures, even cloud scheduling policies—as a population of evolvable candidates. You supply a seed, an evaluator, and a metric; the framework iteratively mutates candidates, evaluates them on minibatches, and maintains a Pareto frontier of variants that excel on different task subsets. It exposes this through a Python library and a growing set of adapters for DSPy, LangChain, MCP, and vector-store-agnostic RAG.

The interesting bit Instead of collapsing execution history into a scalar reward like RL, GEPA feeds full traces—stack traces, profiler output, reasoning logs—into a reflection LLM that writes a diagnosis and proposes a targeted mutation. The team calls this “Actionable Side Information,” essentially using an LLM as a gradient generator for text. A less common move is “system-aware merge,” which combines two Pareto-optimal candidates that specialize on different tasks into a single hybrid.

Key highlights

  • Cited benchmarks claim 35× faster convergence than RL (hundreds of evaluations versus thousands for GRPO) and 90× cost savings over frontier models in Databricks’ testing.
  • The optimize_anything API targets artifacts beyond prompts; reported jumps include 32% → 89% on ARC-AGI agent accuracy and 40.2% cloud scheduling cost savings.
  • Built-in adapters cover DSPy full-program evolution, confidence-aware classification, generic RAG (ChromaDB, Weaviate, Qdrant, Pinecone), and MCP tool descriptions.
  • Already integrated into MLflow, Comet ML Opik, Pydantic AI, Google ADK, and the OpenAI Cookbook.

Caveats

  • The quickstart examples assume access to proprietary reflection LLMs such as openai/gpt-5, so this is not a zero-API-cost or fully offline tool.
  • Many of the dramatic gains and production claims are self-reported by the team or partner organizations; the README does not point to independent reproductions.

Verdict A strong candidate if you are running DSPy or agent pipelines and want automated optimization without hand-tuning every prompt variant. Less compelling if your workflow is simple enough that a few manual prompt edits already suffice.

Frequently asked

What is gepa-ai/gepa?
GEPA is an evolutionary search framework that uses an LLM to read execution traces—errors, logs, profiler output—and write targeted mutations, optimizing any measurable text artifact from prompts to agent architectures.
Is gepa open source?
Yes — gepa-ai/gepa is open source, released under the MIT license.
What language is gepa written in?
gepa-ai/gepa is primarily written in Jupyter Notebook.
How popular is gepa?
gepa-ai/gepa has 5.7k stars on GitHub and is currently cooling off.
Where can I find gepa?
gepa-ai/gepa is on GitHub at https://github.com/gepa-ai/gepa.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.