Skip to content

Upgrade Guide

PydanticAI is still pre-version 1, so breaking changes will occur, however:

  • We try to minimize them as much as possible.
  • We use minor version bumps to signify breaking changes.
  • Wherever possible we deprecate old features so code continues to work with deprecation warnings when changing the public API.
  • We intend to release V1 in summer 2025, and then follow strict semantic versioning, e.g. no intentional breaking changes except in minor or patch versions.

Breaking Changes

Note

Here's a filtered list of the breaking changes for each version to help you upgrade PydanticAI.

v0.1.0 (2025-04-15)

See #1248 — the attribute/parameter name result was renamed to output in many places. Hopefully all changes keep a deprecated attribute or parameter with the old name, so you should get many deprecation warnings.

See #1484 — format_as_xml was moved and made available to import from the package root, e.g. from pydantic_ai import format_as_xml.

Full Changelog

For the full changelog, see GitHub Releases.