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
{{ message }}
Repository navigation
Commit 77b98de
Browse filesBrowse the repository at this point in the historyBrowse files
Restructure README: emphasize compounding memory and adaptive features (#33)
* docs: surface flagship capabilities and tighten README narrative
Lead with a 'What makes KaiEvolve different' section covering the features
that previously had no README coverage, and add deep-dive sections for each:
- Compounding memory: HMRD program summaries + the running literature review
- Adaptive model selection via Thompson sampling over the LLM ensemble
- Multi-file evolution across coordinated EVOLVE-BLOCK ids
- Self-seeding runs with 'kai run --init-from'
Trim filler bullets and the Key Features/How It Works duplication, soften the
'distributed' overclaim to process-based parallelism, and surface the
kernelbench (GPU) and noisy_optimization (stochastic) examples that
substantiate existing platform and noise-aware claims.
* docs: add CLI + web viewer demo GIFs to the README
- docs/viewer/viewer-demo.gif: walkthrough of the kai web viewer (overview ->
run dashboard -> programs table -> approaches), captured from a live run.
- docs/cli/cli-demo.gif: the `kai` CLI runs table.
Embedded in the "Exploring runs" section.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---------
Co-authored-by: Claude <noreply@anthropic.com>
@@ -6,86 +6,86 @@ An open-source evolutionary coding agent that uses LLMs to discover and optimize
6
6
7
7
KaiEvolve is an evolutionary coding agent that uses Large Language Models to automatically optimize and discover algorithms through iterative improvement. Starting from the AlphaEvolve research, it incorporates advanced features for reproducibility, multi-language support, sophisticated evaluation pipelines, and integration with cutting-edge LLM optimization techniques. It serves as both a research platform for evolutionary AI and a practical tool for automated code optimization.
8
8
9
-
### Key Features
10
-
11
-
KaiEvolve implements a comprehensive evolutionary coding system with:
12
-
13
-
-**Evolutionary Coding Agent**: LLM-guided evolution of entire code files (not just functions)
14
-
-**Distributed Controller Loop**: Asynchronous pipeline coordinating LLMs, evaluators, and databases
15
-
-**Program Database**: Storage and sampling of evolved programs with evaluation metrics
16
-
-**Prompt Sampling**: Context-rich prompts with past programs, scores, and problem descriptions
17
-
-**LLM Ensemble**: Multiple language models working together for code generation
18
-
-**Multi-objective Optimization**: Simultaneous optimization of multiple evaluation metrics
19
-
-**Checkpoint System**: Automatic saving and resuming of evolution state
20
-
21
-
#### Scientific Reproducibility
22
-
-**Comprehensive Seeding**: Full deterministic reproduction with hash-based component isolation
23
-
-**Default Reproducibility**: Seed=42 by default for immediate reproducible results
24
-
-**Granular Control**: Per-component seeding for LLMs, database, and evaluation pipeline
25
-
26
-
#### Advanced LLM Integration
27
-
-**Ensemble Sophistication**: Weighted model combinations with intelligent fallback strategies
28
-
-**Test-Time Compute**: Integration with [optillm](https://github.com/codelion/optillm) for Mixture of Agents (MoA) and enhanced reasoning
29
-
-**Universal API Support**: Works with any OpenAI-compatible endpoint (Anthropic, Google, local models)
30
-
-**Plugin Ecosystem**: Support for optillm plugins (readurls, executecode, z3_solver, etc.)
31
-
32
-
#### Evolution Algorithm Innovations
33
-
-**MAP-Elites Implementation**: Quality-diversity algorithm for balanced exploration/exploitation
34
-
-**Island-Based Evolution**: Multiple populations with periodic migration for diversity maintenance
35
-
-**Inspiration vs Performance**: Sophisticated prompt engineering separating top performers from diverse inspirations
36
-
-**Multi-Strategy Selection**: Elite, diverse, and exploratory program sampling strategies
37
-
-**Adaptive Feature Dimensions**: Default features (complexity & diversity) with customizable multi-dimensional search spaces
38
-
39
-
#### Evaluation and Feedback Systems
40
-
-**Artifacts Side-Channel**: Capture build errors, profiling data, and execution feedback for LLM improvement
41
-
-**Cascade Evaluation**: Multi-stage testing with progressive complexity for efficient resource usage
42
-
-**LLM-Based Feedback**: Automated code quality assessment and reasoning capture
43
-
-**Comprehensive Error Handling**: Graceful recovery from evaluation failures with detailed diagnostics
44
-
45
-
#### Multi-Language and Platform Support
46
-
-**Language Agnostic**: Python, Rust, R, Metal shaders, and more
47
-
-**Platform Optimization**: Apple Silicon GPU kernels, CUDA optimization, CPU-specific tuning
-**`kai` CLI**: A guided terminal experience with a live `monitor`, one-shot `runs`/`show`/`best` tables, side-by-side `compare`, `export` to CSV/JSON, and live human `steer` (see [Exploring runs](#exploring-runs-the-kai-cli-and-web-viewer))
52
-
-**Interactive web viewer**: `kai viewer` opens per-run dashboards, a sortable programs browser, an *approaches* synthesis of the strategies the AI tried, and **interactive solution visualizations** drawn by an optional per-task `visualize.py`
53
-
-**Benchmarking harness**: A/B whole setups across tasks on a shared scale with reproducible seeds
54
-
-**Error Recovery**: Robust checkpoint loading with automatic fix for common serialization issues
55
-
56
-
#### Performance and Scalability
57
-
-**Process-Based Parallelism**: True parallel execution bypassing Python's GIL for CPU-bound tasks
58
-
-**Resource Management**: Memory limits, timeouts, and resource monitoring
59
-
-**Efficient Storage**: Optimized database with artifact management and cleanup policies
9
+
### What makes KaiEvolve different
10
+
11
+
A faithful AlphaEvolve loop gets you mutation, evaluation, and a quality-diversity
12
+
archive. KaiEvolve adds the machinery that makes *long* runs actually compound —
13
+
the search remembers what it learned and steers itself instead of re-deriving the
14
+
problem every iteration:
15
+
16
+
-**Compounding memory (HMRD + running literature review)** — every successful
17
+
program carries a 4-section *Hypothesis / Method / Result / Discussion* summary.
18
+
At each checkpoint, KaiEvolve distills only the *new* programs into a bounded
19
+
"lab notebook" that is injected into every prompt and persists to disk, so the
20
+
LLM builds on accumulated knowledge rather than a rotating window of neighbors —
21
+
and a fresh run can pick up where the last one left off. See
Five open mathematical problems from the AlphaEvolve paper (autocorrelation_C1, packing_circles_max_sum_of_radii, no_isosceles_triangles, happy_ending, unit_distances), each packaged as an initial program plus evaluator. Run them with the suite config tuned for these tasks, [`configs/bench_alphaevolve.yaml`](configs/bench_alphaevolve.yaml).
0 commit comments