For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
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.
Date
Version
Highlights
2026-02-24
3.1.0
Reintroduced MCP/tool optimization across optimizers, added optimizer benchmark runtime/engine refactor, improved multi-metric span wiring and fail-fast scoring behavior, and added Python 3.14 support. Commits →
2026-01-28
3.0.1
Suppress 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-26
3.0.0
Major 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.
