ContextQMD
Back to Pydantic Ai

Installation

docs/install.md

2.0.0b16.8 KB
Original Source

Installation

Pydantic AI is available on PyPI as pydantic-ai so installation is as simple as:

bash
pip/uv-add pydantic-ai

(Requires Python 3.10+)

This installs the pydantic_ai package, core dependencies, and libraries required to use the OpenAI, Anthropic, and Google models, plus the CLI, MCP, Evals, Web UI, Retries, and Logfire integrations. To use any other models or integrations, add the relevant extras to your install command, e.g. pydantic-ai[bedrock,temporal]. Alternatively, you can install the pydantic-ai-slim package with only the extras you need.

Use with Pydantic Logfire

Pydantic AI has an excellent (but completely optional) integration with Pydantic Logfire to help you view and understand agent runs.

Logfire comes included with pydantic-ai (but not the "slim" version), so you can typically start using it immediately by following the Logfire setup docs.

Running Examples

We distribute the pydantic_ai_examples directory as a separate PyPI package (pydantic-ai-examples) to make examples extremely easy to customize and run.

To install examples, use the examples optional group:

bash
pip/uv-add "pydantic-ai[examples]"

To run the examples, follow instructions in the examples docs.

Slim Install

If you know which model you're going to use and want to avoid installing superfluous packages, you can use the pydantic-ai-slim package. For example, if you're using just [OpenAIChatModel][pydantic_ai.models.openai.OpenAIChatModel], you would run:

bash
pip/uv-add "pydantic-ai-slim[openai]"

pydantic-ai-slim has the following optional groups:

You can also install dependencies for multiple models and use cases, for example:

bash
pip/uv-add "pydantic-ai-slim[openai,google,logfire]"