ai-agent

pydantic-ai: Build AI Agents

Name: pydantic-ai: Build AI Agents
Author: pydantic

Get an AI agent framework with pydantic-ai, for founders. 18k+ GitHub stars

18,244 stars2,310 forksPythonQuality 8/10Updated 7/6/2026100% free · open source

What it does

Pydantic-ai provides a framework for building AI agents using Pydantic, allowing founders to create structured and scalable AI models

Install / run

pip install pydantic-ai

When to use it

•When building a custom AI model that requires strict data validation and typing
•When integrating AI capabilities into an existing Pydantic-based application
•When needing to create a scalable and maintainable AI agent framework

Quick start

1Create a new Pydantic model by defining a class that inherits from `pydantic.BaseModel`
2Use the `@pydantic_ai.agent` decorator to define an AI agent
3Configure the agent by passing a `config` dictionary to the `agent` decorator
4Train the agent using the `train` method, passing in a dataset and optional hyperparameters
5Deploy the trained agent using the `deploy` method, specifying a deployment target such as a REST API or message queue

Ready-to-paste prompt

from pydantic_ai import agent; @agent(config={'model': 'resnet50', 'task': 'image_classification'}) class MyAgent(pydantic.BaseModel): pass

Heads up: Ensure you have the latest version of Pydantic installed, as pydantic-ai relies on Pydantic's latest features, and older versions may cause compatibility issues

Saves to your device