gepa-ai · Shangyint · Apr 13, 2026 · Apr 13, 2026 · Apr 22, 2026 · Apr 22, 2026
diff --git a/.gitignore b/.gitignore
@@ -216,3 +216,4 @@ __marimo__/
 runs/
 outputs/
 gepa_terminus/
+archive/
diff --git a/docs/docs/api/index.md b/docs/docs/api/index.md
@@ -4,9 +4,23 @@ Welcome to the GEPA API Reference. This documentation is auto-generated from the
 
 ## optimize_anything
 
-The primary public API for GEPA. Optimize any text artifact with LLM-guided evolution — bring a seed candidate and an evaluator, and GEPA handles the rest.
+The primary public API for GEPA. Define a task, provide an evaluator, and choose an optimization engine.
 
 - [`optimize_anything`](optimize_anything/optimize_anything.md)
+- [`Task`](optimize_anything/Task.md)
+- [`OptimizeAnythingConfig`](optimize_anything/OptimizeAnythingConfig.md)
+- [`Engine`](optimize_anything/Engine.md)
+- [`Result`](optimize_anything/Result.md)
+- [`EvalServer`](optimize_anything/EvalServer.md)
+- [`BudgetTracker`](optimize_anything/BudgetTracker.md)
+- [`optimize_anything_with_server`](optimize_anything/optimize_anything_with_server.md)
+- [`list_engines`](optimize_anything/list_engines.md)
+- [`register_engine`](optimize_anything/register_engine.md)
+
+## GEPA Engine
+
+Configuration for the built-in GEPA engine (`engine="gepa"`). These classes are passed via `OptimizeAnythingConfig(engine_config={...})` to control GEPA-specific behavior.
+
 - [`GEPAConfig`](optimize_anything/GEPAConfig.md)
 - [`EngineConfig`](optimize_anything/EngineConfig.md)
 - [`ReflectionConfig`](optimize_anything/ReflectionConfig.md)
@@ -119,4 +133,3 @@ Strategies for various aspects of the optimization process.
 - [`EvaluationPolicy`](strategies/EvaluationPolicy.md)
 - [`FullEvaluationPolicy`](strategies/FullEvaluationPolicy.md)
 - [`InstructionProposalSignature`](strategies/InstructionProposalSignature.md)
-
diff --git a/docs/docs/api/optimize_anything/BudgetTracker.md b/docs/docs/api/optimize_anything/BudgetTracker.md
@@ -0,0 +1,15 @@
+# BudgetTracker
+
+::: gepa.optimize_anything.BudgetTracker
+    handler: python
+    options:
+        show_source: true
+        show_root_heading: true
+        heading_level: 2
+        docstring_style: google
+        show_root_full_path: true
+        show_object_full_path: false
+        separate_signature: false
+        inherited_members: true
+        members_order: source
+        show_signature_annotations: true
diff --git a/docs/docs/api/optimize_anything/Engine.md b/docs/docs/api/optimize_anything/Engine.md
@@ -0,0 +1,15 @@
+# Engine
+
+::: gepa.optimize_anything.Engine
+    handler: python
+    options:
+        show_source: true
+        show_root_heading: true
+        heading_level: 2
+        docstring_style: google
+        show_root_full_path: true
+        show_object_full_path: false
+        separate_signature: false
+        inherited_members: true
+        members_order: source
+        show_signature_annotations: true
diff --git a/docs/docs/api/optimize_anything/EngineConfig.md b/docs/docs/api/optimize_anything/EngineConfig.md
@@ -1,6 +1,6 @@
 # EngineConfig
 
-::: gepa.optimize_anything.EngineConfig
+::: gepa.legacy_optimize_anything.EngineConfig
     handler: python
     options:
         show_source: true

diff --git a/docs/docs/api/optimize_anything/EvalServer.md b/docs/docs/api/optimize_anything/EvalServer.md
@@ -0,0 +1,15 @@
+# EvalServer
+
+::: gepa.optimize_anything.EvalServer
+    handler: python
+    options:
+        show_source: true
+        show_root_heading: true
+        heading_level: 2
+        docstring_style: google
+        show_root_full_path: true
+        show_object_full_path: false
+        separate_signature: false
+        inherited_members: true
+        members_order: source
+        show_signature_annotations: true
diff --git a/docs/docs/api/optimize_anything/Evaluator.md b/docs/docs/api/optimize_anything/Evaluator.md
@@ -1,6 +1,6 @@
 # Evaluator
 
-::: gepa.optimize_anything.Evaluator
+::: gepa.legacy_optimize_anything.Evaluator
     handler: python
     options:
         show_source: true

diff --git a/docs/docs/api/optimize_anything/GEPAConfig.md b/docs/docs/api/optimize_anything/GEPAConfig.md
@@ -1,6 +1,6 @@
 # GEPAConfig
 
-::: gepa.optimize_anything.GEPAConfig
+::: gepa.legacy_optimize_anything.GEPAConfig
     handler: python
     options:
         show_source: true

diff --git a/docs/docs/api/optimize_anything/LogContext.md b/docs/docs/api/optimize_anything/LogContext.md
@@ -1,6 +1,6 @@
 # LogContext
 
-::: gepa.optimize_anything.LogContext
+::: gepa.legacy_optimize_anything.LogContext
     handler: python
     options:
         show_source: true

diff --git a/docs/docs/api/optimize_anything/MergeConfig.md b/docs/docs/api/optimize_anything/MergeConfig.md
@@ -1,6 +1,6 @@
 # MergeConfig
 
-::: gepa.optimize_anything.MergeConfig
+::: gepa.legacy_optimize_anything.MergeConfig
     handler: python
     options:
         show_source: true

diff --git a/docs/docs/api/optimize_anything/OptimizationState.md b/docs/docs/api/optimize_anything/OptimizationState.md
@@ -1,6 +1,6 @@
 # OptimizationState
 
-::: gepa.optimize_anything.OptimizationState
+::: gepa.legacy_optimize_anything.OptimizationState
     handler: python
     options:
         show_source: true

diff --git a/docs/docs/api/optimize_anything/OptimizeAnythingConfig.md b/docs/docs/api/optimize_anything/OptimizeAnythingConfig.md
@@ -0,0 +1,15 @@
+# OptimizeAnythingConfig
+
+::: gepa.optimize_anything.OptimizeAnythingConfig
+    handler: python
+    options:
+        show_source: true
+        show_root_heading: true
+        heading_level: 2
+        docstring_style: google
+        show_root_full_path: true
+        show_object_full_path: false
+        separate_signature: false
+        inherited_members: true
+        members_order: source
+        show_signature_annotations: true
diff --git a/docs/docs/api/optimize_anything/RefinerConfig.md b/docs/docs/api/optimize_anything/RefinerConfig.md
@@ -1,6 +1,6 @@
 # RefinerConfig
 
-::: gepa.optimize_anything.RefinerConfig
+::: gepa.legacy_optimize_anything.RefinerConfig
     handler: python
     options:
         show_source: true

diff --git a/docs/docs/api/optimize_anything/ReflectionConfig.md b/docs/docs/api/optimize_anything/ReflectionConfig.md
@@ -1,6 +1,6 @@
 # ReflectionConfig
 
-::: gepa.optimize_anything.ReflectionConfig
+::: gepa.legacy_optimize_anything.ReflectionConfig
     handler: python
     options:
         show_source: true

diff --git a/docs/docs/api/optimize_anything/Result.md b/docs/docs/api/optimize_anything/Result.md
@@ -0,0 +1,15 @@
+# Result
+
+::: gepa.optimize_anything.Result
+    handler: python
+    options:
+        show_source: true
+        show_root_heading: true
+        heading_level: 2
+        docstring_style: google
+        show_root_full_path: true
+        show_object_full_path: false
+        separate_signature: false
+        inherited_members: true
+        members_order: source
+        show_signature_annotations: true
diff --git a/docs/docs/api/optimize_anything/Task.md b/docs/docs/api/optimize_anything/Task.md
@@ -0,0 +1,15 @@
+# Task
+
+::: gepa.optimize_anything.Task
+    handler: python
+    options:
+        show_source: true
+        show_root_heading: true
+        heading_level: 2
+        docstring_style: google
+        show_root_full_path: true
+        show_object_full_path: false
+        separate_signature: false
+        inherited_members: true
+        members_order: source
+        show_signature_annotations: true
diff --git a/docs/docs/api/optimize_anything/TrackingConfig.md b/docs/docs/api/optimize_anything/TrackingConfig.md
@@ -1,6 +1,6 @@
 # TrackingConfig
 
-::: gepa.optimize_anything.TrackingConfig
+::: gepa.legacy_optimize_anything.TrackingConfig
     handler: python
     options:
         show_source: true

diff --git a/docs/docs/api/optimize_anything/get_log_context.md b/docs/docs/api/optimize_anything/get_log_context.md
@@ -1,6 +1,6 @@
 # get_log_context
 
-::: gepa.optimize_anything.get_log_context
+::: gepa.legacy_optimize_anything.get_log_context
     handler: python
     options:
         show_source: true

diff --git a/docs/docs/api/optimize_anything/list_engines.md b/docs/docs/api/optimize_anything/list_engines.md
@@ -0,0 +1,15 @@
+# list_engines
+
+::: gepa.optimize_anything.list_engines
+    handler: python
+    options:
+        show_source: true
+        show_root_heading: true
+        heading_level: 2
+        docstring_style: google
+        show_root_full_path: true
+        show_object_full_path: false
+        separate_signature: false
+        inherited_members: true
+        members_order: source
+        show_signature_annotations: true
diff --git a/docs/docs/api/optimize_anything/log.md b/docs/docs/api/optimize_anything/log.md
@@ -1,6 +1,6 @@
 # log
 
-::: gepa.optimize_anything.log
+::: gepa.legacy_optimize_anything.log
     handler: python
     options:
         show_source: true

diff --git a/docs/docs/api/optimize_anything/make_litellm_lm.md b/docs/docs/api/optimize_anything/make_litellm_lm.md
@@ -1,6 +1,6 @@
 # make_litellm_lm
 
-::: gepa.optimize_anything.make_litellm_lm
+::: gepa.legacy_optimize_anything.make_litellm_lm
     handler: python
     options:
         show_source: true

diff --git a/docs/docs/api/optimize_anything/optimize_anything_with_server.md b/docs/docs/api/optimize_anything/optimize_anything_with_server.md
@@ -0,0 +1,15 @@
+# optimize_anything_with_server
+
+::: gepa.optimize_anything.optimize_anything_with_server
+    handler: python
+    options:
+        show_source: true
+        show_root_heading: true
+        heading_level: 2
+        docstring_style: google
+        show_root_full_path: true
+        show_object_full_path: false
+        separate_signature: false
+        inherited_members: true
+        members_order: source
+        show_signature_annotations: true
diff --git a/docs/docs/api/optimize_anything/register_engine.md b/docs/docs/api/optimize_anything/register_engine.md
@@ -0,0 +1,15 @@
+# register_engine
+
+::: gepa.optimize_anything.register_engine
+    handler: python
+    options:
+        show_source: true
+        show_root_heading: true
+        heading_level: 2
+        docstring_style: google
+        show_root_full_path: true
+        show_object_full_path: false
+        separate_signature: false
+        inherited_members: true
+        members_order: source
+        show_signature_annotations: true
diff --git a/docs/docs/api/optimize_anything/set_log_context.md b/docs/docs/api/optimize_anything/set_log_context.md
@@ -1,6 +1,6 @@
 # set_log_context
 
-::: gepa.optimize_anything.set_log_context
+::: gepa.legacy_optimize_anything.set_log_context
     handler: python
     options:
         show_source: true

diff --git a/docs/docs/blog/posts/2026-02-18-introducing-optimize-anything/index.md b/docs/docs/blog/posts/2026-02-18-introducing-optimize-anything/index.md
@@ -435,7 +435,7 @@ The seedless mode is particularly useful for tasks where the solution space is l
 
 The key ideas: (1) **three unified modes** (single-task search, multi-task search, and generalization) under one declarative API; (2) **Actionable Side Information (ASI)** as a first-class API concept that turns blind mutation into targeted, diagnostic-driven engineering; (3) **Pareto-efficient search** across metrics and examples that outperforms naive all-at-once optimization.
 
-By design, `optimize_anything` is a general frontend for text optimization. It is currently powered by GEPA as the optimization backend, but the API is backend-agnostic: as new optimization strategies emerge with increasingly powerful models, they can be plugged in without changing any user code. Our goal is for `optimize_anything` to always dispatch to the best available optimizer for your problem. We welcome community contributions of new optimization backends, evaluators, and case studies.
+By design, `optimize_anything` is a general frontend for text optimization. It is currently powered by GEPA as the default optimization engine, but the API is engine-agnostic: as new optimization strategies emerge with increasingly powerful models, they can be plugged in without changing any user code. Our goal is for `optimize_anything` to always dispatch to the best available optimizer for your problem. We welcome community contributions of new optimization engines, evaluators, and case studies.
 
 Get started:
 

diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml
@@ -45,6 +45,16 @@ nav:
         - API Overview: api/index.md
         - optimize_anything:
             - optimize_anything: api/optimize_anything/optimize_anything.md
+            - Task: api/optimize_anything/Task.md
+            - OptimizeAnythingConfig: api/optimize_anything/OptimizeAnythingConfig.md
+            - Engine: api/optimize_anything/Engine.md
+            - Result: api/optimize_anything/Result.md
+            - EvalServer: api/optimize_anything/EvalServer.md
+            - BudgetTracker: api/optimize_anything/BudgetTracker.md
+            - optimize_anything_with_server: api/optimize_anything/optimize_anything_with_server.md
+            - list_engines: api/optimize_anything/list_engines.md
+            - register_engine: api/optimize_anything/register_engine.md
+        - GEPA Engine:
             - GEPAConfig: api/optimize_anything/GEPAConfig.md
             - EngineConfig: api/optimize_anything/EngineConfig.md
             - ReflectionConfig: api/optimize_anything/ReflectionConfig.md