Skip to content
Docs Pydantic Docs

Installation

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

Terminal
pip install 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, 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.

TLS certificates

Pydantic AI’s own HTTP requests, and those of providers migrated to httpx2, verify TLS certificates against the operating system trust store rather than shipping a certifi bundle. Minimal container images and corporate proxies that rely on a private CA therefore need those certificates installed in the image (for example the ca-certificates package, plus your proxy’s root CA). Alternatively, pass such a provider an httpx2.AsyncClient you configured yourself through its http_client argument — see the provider docs for the client each one accepts. Providers whose SDKs still use legacy httpx (such as Anthropic and Cohere) keep its certifi-based verification and take a legacy httpx.AsyncClient instead.

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:

Terminal
pip install "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, you would run:

Terminal
pip install "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:

Terminal
pip install "pydantic-ai-slim[openai,google,logfire]"