DSPy: The framework for programming—not prompting—language models
Python
[docs] Add GEPA gepa_kwargs documentation (#8998)
Gabriel Loiseaud81dd4cea2f8
diff --git a/dspy/teleprompt/gepa/gepa.py b/dspy/teleprompt/gepa/gepa.pyindex 87cbbf80a..f32483bd6 100644--- a/dspy/teleprompt/gepa/gepa.py+++ b/dspy/teleprompt/gepa/gepa.py@@ -243,7 +243,7 @@ class GEPA(Teleprompter):Note: When both instruction_proposer and reflection_lm are set, the instruction_proposer is calledin the reflection_lm context. However, reflection_lm is optional when using a custom instruction_proposer.Custom instruction proposers can invoke their own LLMs if needed.- component_selector: Custom component selector implementing the ReflectionComponentSelector protocol,+ component_selector: Custom component selector implementing the [ReflectionComponentSelector](https://github.com/gepa-ai/gepa/blob/main/src/gepa/proposer/reflective_mutation/base.py) protocol,or a string specifying a built-in selector strategy. Controls which components (predictors) are selectedfor optimization at each iteration. Defaults to 'round_robin' strategy which cycles through componentsone at a time. Available string options: 'round_robin' (cycles through components sequentially),@@ -274,7 +274,34 @@ class GEPA(Teleprompter):called with and without the pred_name. This flag (defaults to True) determines whether a warning israised if a mismatch in module-level and predictor-level score is detected.seed: The random seed to use for reproducibility. Default is 0.- gepa_kwargs: (Optional) provide additional kwargs to be passed to [gepa.optimize](https://github.com/gepa-ai/gepa/blob/main/src/gepa/api.py) method+ gepa_kwargs: (Optional) Additional keyword arguments to pass directly to [gepa.optimize](https://github.com/gepa-ai/gepa/blob/main/src/gepa/api.py).+ Useful for accessing advanced GEPA features not directly exposed through DSPy's GEPA interface.++ Available parameters:+ - batch_sampler: Strategy for selecting training examples. Can be a [BatchSampler](https://github.com/gepa-ai/gepa/blob/main/src/gepa/strategies/batch_sampler.py) instance or a string+ ('epoch_shuffled'). Defaults to 'epoch_shuffled'. Only valid when reflection_minibatch_size is None.+ - merge_val_overlap_floor: Minimum number of shared validation ids required between parents before+ attempting a merge subsample. Only relevant when using `val_evaluation_policy` other than 'full_eval'.+ Default is 5.+ - stop_callbacks: Optional stopper(s) that return True when optimization should stop. Can be a single+ [StopperProtocol](https://github.com/gepa-ai/gepa/blob/main/src/gepa/utils/stop_condition.py) or a list of StopperProtocol instances.+ Examples: [FileStopper](https://github.com/gepa-ai/gepa/blob/main/src/gepa/utils/stop_condition.py),+ [TimeoutStopCondition](https://github.com/gepa-ai/gepa/blob/main/src/gepa/utils/stop_condition.py),+ [SignalStopper](https://github.com/gepa-ai/gepa/blob/main/src/gepa/utils/stop_condition.py),+ [NoImprovementStopper](https://github.com/gepa-ai/gepa/blob/main/src/gepa/utils/stop_condition.py),+ or custom stopping logic. Note: This overrides the default+ max_metric_calls stopping condition.+ - use_cloudpickle: Use cloudpickle instead of pickle for serialization. Can be helpful when the+ serialized state contains dynamically generated DSPy signatures. Default is False.+ - val_evaluation_policy: Strategy controlling which validation ids to score each iteration. Can be+ 'full_eval' (evaluate every id each time) or an [EvaluationPolicy](https://github.com/gepa-ai/gepa/blob/main/src/gepa/strategies/eval_policy.py) instance. Default is 'full_eval'.+ - use_mlflow: If True, enables MLflow integration to log optimization progress.+ MLflow can be used alongside Weights & Biases (WandB).+ - mlflow_tracking_uri: The tracking URI to use for MLflow (when use_mlflow=True).+ - mlflow_experiment_name: The experiment name to use for MLflow (when use_mlflow=True).++ Note: Parameters already handled by DSPy's GEPA class will be overridden by the direct parameters+ and should not be passed through gepa_kwargs.Note:Budget Configuration: Exactly one of `auto`, `max_full_evals`, or `max_metric_calls` must be provided.