Getting Started

Changelog

Stay current on Agent Optimizer updates. Each entry below reflects a version bump in sdks/opik_optimizer/pyproject.toml on main. The compare links jump straight to the commits that landed in that release. As Opik is a monorepo, you will see other non-optimizer related changes in the commit links below.

Version 3.x

Highlights: Full public, production-ready release designed to work alongside Optimization Studio. MCP/tool optimization is temporarily removed in 3.0.0–3.0.1 due to compatibility reasons.

Version 3 highlights

  • First fully native multi-agent and multi-prompt optimization support end-to-end across optimizers.
  • Specific reasoning models separate from training supported across all optimizers.
  • Multimodal optimization supported across all optimizers.
  • Pass@k evaluation across all optimizers via the n parameter and selection policies.
  • Full refactor and normalization of all optimizers for simpler code and better performance.
DateVersionHighlights
TBD3.1.0Brings back tool optimization (MCP/tooling support).
2026-01-283.0.1Suppress noisy Hugging Face notebook warnings, fix HotpotQA multihop agent with new LiteLLM calls + JSON mode, map missing error enum so UI shows “Error”, HRPO rich output fixes and performance improvements, sanitize attachment spans to prevent output errors, fix HRPO async in notebooks.
2026-01-263.0.0Major rewrite: native multi-agent/multi-prompt optimization, reasoning model support, pass@k evaluation, and optimizer refactor. Breaking change: MCP-based optimizers removed. Commits →

Version 2.x

Highlights: Introduced new optimizers including HRPO and GEPA, tool optimization and expanding coverage beyond early prompt-only workflows. Breaking change includes dropping MIPRO in favour of GEPA.

DateVersionHighlights
2026-01-222.3.12Fixes for optimizer breaking issues. Commits →
2026-01-062.3.11Fixed hierarchical optimizer reason handling and numeric equals. Commits →
2025-12-242.3.10Added missing model parameter in HRPO. Commits →
2025-12-192.3.9Fixed hierarchical optimizer recreating optimizations when ID is provided. Commits →
2025-12-152.3.8Fixed Evolutionary Optimizer with OpenAI Responses API, added validation in GEPA, updated multimodal example. Commits →
2025-12-152.3.7Renamed Hierarchical optimizer to HAPO, fixed MetaPrompt inheritance, lint cleanup. Commits →
2025-12-022.3.6Bumped opik_optimizer, added optimization_id skip, cost/latency metrics, GEPA API/log fixes. Commits →
2025-11-242.3.5Version mismatch fix and Few-Shot Optimizer improvements. Commits →
2025-11-242.3.4Optimizer tests, benchmarks, and MetaPrompt improvements. Commits →
2025-11-222.3.3Benchmarks refactor, fixed validation dataset support in Few-Shot Optimizer. Commits →
2025-11-212.3.2Agent examples fixes. Commits →
2025-11-212.3.1Fixed validation datasets, refactored optimizers to dedicated prompts modules. Commits →
2025-11-212.3.0Validation dataset support, better logging and eval traces, optimizer version bump. Commits →
2025-11-212.2.7Cache/speed improvements for e2e and workflows, GEPA adapter fixes. Commits →
2025-11-202.2.6Refactored Datasets API. Commits →
2025-11-202.2.5Ensured OptimizableAgent support, minor fixes. Commits →
2025-11-192.2.4Added multimodal optimization e2e test. Commits →
2025-11-192.2.3Manifest-based task support, extra benchmark datasets. Commits →
2025-11-182.2.2Multimodal input support for HRPO, algorithms package refactor, custom run names. Commits →
2025-11-082.2.1Removed cache, added MCP agent prompt, benchmarks, fixed GEPA e2e tests. Commits →
2025-10-232.2.0Public method refactor and optimizer cleanup. Commits →
2025-10-232.1.3Multi-metric optimization objectives, HRPO logging improvements, public method refactor. Commits →
2025-10-112.1.2Fixed missing optimizer names across metadata. Commits →
2025-10-102.1.1Introduced the Hierarchical Reflective Optimizer. Commits →
2025-10-092.1.0Pinned LiteLLM, shipped optimizer API docs, added parameter-only tuning. Commits →
2025-10-022.0.1Added GEPA dependency and test package init files. Commits →
2025-10-012.0.0Updated pyproject.toml for v2.0 release. Commits →

Version 1.x

Highlights: Initial research release for testing early internal optimizers MetaPrompter, Evolutionary and support for MIPRO.

DateVersionHighlights
2025-10-011.1.0Optimizer MCP with EO, signature refactor, docs and dotfiles for optimizer release. Commits →
2025-09-241.0.6Initial optimizer packaging cleanup. Commit →

Looking for older updates? Browse the full Opik changelog and filter by the Agent Optimization tag.