Examples

Examples of how to use Pydantic AI and what it can do.

Usage

These examples are distributed with pydantic-ai so you can run them either by cloning the pydantic-ai repo or by simply installing pydantic-ai from PyPI with pip or uv.

Installing required dependencies

Either way you'll need to install extra dependencies to run some examples, you just need to install the examples optional dependency group.

If you've installed pydantic-ai via pip/uv, you can install the extra dependencies with:

pipuv

pip install 'pydantic-ai[examples]'

uv add 'pydantic-ai[examples]'

If you clone the repo, you should instead use uv sync --extra examples to install extra dependencies.

Setting model environment variables

All these examples will need you to set either:

• OPENAI_API_KEY to use OpenAI models, go to platform.openai.com and follow your nose until you find how to generate an API key
• or, GEMINI_API_KEY to use Google Gemini models, go to aistudio.google.com and do the same to generate an API key

Then set the API key as an environment variable with:

OpenAIGoogle Gemini

export OPENAI_API_KEY=your-api-key

export GEMINI_API_KEY=your-api-key

Running Examples

To run the examples (this will work whether you installed pydantic_ai, or cloned the repo), run:

pipuv

python -m pydantic_ai_examples.<example_module_name>

uv run -m pydantic_ai_examples.<example_module_name>

For examples, to run the very simple pydantic_model example:

pipuv

python -m pydantic_ai_examples.pydantic_model

uv run -m pydantic_ai_examples.pydantic_model

If you like one-liners and you're using uv, you can run a pydantic-ai example with zero setup:

OPENAI_API_KEY='your-api-key' \
  uv run --with 'pydantic-ai[examples]' \
  -m pydantic_ai_examples.pydantic_model

---

You'll probably want to edit examples in addition to just running them. You can copy the examples to a new directory with:

pipuv

python -m pydantic_ai_examples --copy-to examples/

uv run -m pydantic_ai_examples --copy-to examples/