What’s New in Symfony AI v0.2.0? Key Features, Improvements, and Upgrade Guide

Release Overview

Symfony AI v0.2.0 was released on 2026-01-10. It is the first major update after v0.1.0 and adds new features, refactoring, and compatibility improvements for the Mate development assistant, Platform model integration, Store vector storage, and Chat/Agent components.

Key Highlights

Mate component: CLI command descriptions added, new debug commands debug:capabilities and debug:extensions, compatibility with Symfony 5.4 and 6.4, compiled container usage, support for _composer_autoload_path, and improved error handling.

Platform component: added Whisper verbose output, FailoverPlatform for automatic fallback, Gemini example support, OpenRouter streaming and structured output, VertexAI API‑Key authentication, and refined StructuredOutput error handling and nullable type processing in ToolNormalizer.

Store interface: method StoreInterface::add() signature changed to accept a VectorDocument|array instead of variadic arguments; updated description for the force option; Cloudflare pagination and key‑access fixes; Doctrine DBAL 4 compatibility for MariaDB and PostgreSQL stores.

Chat component: Message normalizer now accepts document type.

AI Bundle: platform can be configured through the bundle (e.g., TransformersPhp).

CI and tooling: improved CI workflow, automatic GitHub PR‑close templates, removal of redundant dependencies, updates to doctor‑rst and PHP‑CS‑Fixer, and increased static analysis and test coverage.

Demo applications: new bundle and chroma recipe examples, updated Google model demos.

Significant Refactoring

Mate migrated to a compiled container and underwent extensive refactoring of ContainerFactory and ComposerExtensionDiscovery.

Many components removed variadic parameters in favor of modern type‑safe signatures.

Compatibility Fixes

Added Symfony 5.4 and 6.4 support for Mate.

Fixed Cloudflare vector storage pagination and key‑access issues.

Doctrine DBAL 4 compatibility adjustments for MariaDB and PostgreSQL stores.

Removed redundant dependencies and updated toolchain components.

Upgrade Recommendation

Projects using Symfony AI for agents, retrieval‑augmented generation, or chatbot development should upgrade to the 0.2.x series to obtain the stability improvements, new capabilities, and forward‑compatible support.

Release URL

https://github.com/symfony/ai/releases/tag/v0.2.0