You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+18Lines changed: 18 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,6 +2,8 @@
2
2
3
3
An open-source implementation of the AlphaEvolve system described in the Google DeepMind paper "AlphaEvolve: A coding agent for scientific and algorithmic discovery" (2025).
4
4
5
+

6
+
5
7
## Overview
6
8
7
9
OpenEvolve is an evolutionary coding agent that uses Large Language Models to optimize code through an iterative process. It orchestrates a pipeline of LLM-based code generation, evaluation, and selection to continuously improve programs for a variety of tasks.
@@ -18,11 +20,15 @@ Key features:
18
20
19
21
OpenEvolve follows an evolutionary approach with the following components:
1.**Prompt Sampler**: Creates context-rich prompts containing past programs, their scores, and problem descriptions
22
26
2.**LLM Ensemble**: Generates code modifications via an ensemble of language models
23
27
3.**Evaluator Pool**: Tests generated programs and assigns scores
24
28
4.**Program Database**: Stores programs and their evaluation metrics, guiding future evolution
25
29
30
+
The controller orchestrates interactions between these components in an asynchronous pipeline, maximizing throughput to evaluate as many candidate solutions as possible.
31
+
26
32
## Getting Started
27
33
28
34
### Installation
@@ -151,6 +157,18 @@ See the [Configuration Guide](configs/default_config.yaml) for a full list of op
151
157
152
158
See the `examples/` directory for complete examples of using OpenEvolve on various problems:
153
159
160
+
### Circle Packing
161
+
162
+
Our implementation of the circle packing problem from the AlphaEvolve paper, where we successfully match their reported results within 0.04%.
163
+
164
+
[Explore the Circle Packing Example](examples/circle_packing/)
165
+
166
+
### Function Minimization
167
+
168
+
An example showing how OpenEvolve can transform a simple random search algorithm into a sophisticated simulated annealing approach.
169
+
170
+
[Explore the Function Minimization Example](examples/function_minimization/)
0 commit comments