Pydantic AI
Open source Python agent framework from the Pydantic team, with typed tools, durable execution, the Pydantic AI Harness capability library and Pydantic Evals.
Pydantic AI is an open source Python agent framework from the Pydantic team, built around typed, validated inputs and outputs. Agents work with models from a very wide range of providers, call function tools, toolsets and MCP servers, and can be composed into multi-agent systems through subagents and an orchestrator that coordinates a catalog of sub-agents. Durable execution through Temporal, DBOS, Prefect, Restate and other backends lets long-running agents survive crashes and restarts, and deferred tools let a developer require human approval before sensitive calls, conditioned on the call's arguments.
Pydantic AI Harness adds more than 30 capabilities, among them persistent namespaced memory, guardrails, sandboxed file and shell access, a Playwright-driven browser, planning and context compaction, plus complete agents such as Coder for autonomous coding and Researcher for source-backed web research. Pydantic Evals scores agents against datasets, and built-in OpenTelemetry instrumentation sends traces to any compatible backend.
The framework is free. Pydantic sells Pydantic Logfire, an observability platform, and a model gateway as separate products.
Vendor details
Canonical URL
https://pydantic.dev/docs/ai/
Category
Agent infrastructure
Subcategory
Agent framework (OSS)
Company status
first party product
Use cases & customers
Primary use cases
Target customers
Deployment options
In practice
You're building an agent in Python and want a framework that feels native to the language. Pydantic AI is an open-source Python agent framework with strong tooling and model flexibility.
You don't want to be locked to one model provider in your agent stack. Pydantic AI is model-flexible, so you can switch the underlying model as needs change.
An agent in production is a black box until something breaks. Pydantic AI offers observability through Logfire, so you can see what your agent is actually doing.
Sources & related URLs
Agentic Index coverage score
12.0 / 14 capabilities · 86%
| Integrations & Tool Calling | Full |
|---|---|
|
First class Model Context Protocol support plus Agent2Agent and UI event stream standards, with built in capabilities for web search, web fetch, image generation, tool search, code execution and file access, and a composable capability system bundling tools, hooks, instructions and model settings into reusable units that can be built in house or installed as third party capability packages. Sourcepydantic.dev/docs/ai/tools-toolsets/toolsetsread 2026-09-21 |
|
| Workflow Orchestration | Full |
|
Agents compose into multi-agent systems through subagents and a dynamic workflow capability in which an orchestrator coordinates a catalog of sub-agents with fan-out, chaining and voting, and durable execution through Temporal, DBOS, Prefect, Restate and other backends lets long-running runs survive crashes and restarts. SourcePydantic AI, pydantic.dev/docs/ai durable execution and harness pagesread 2026-09-21 |
|
| Knowledge Grounding & RAG | Partial |
|
A typed Embedder API generates embeddings across providers for semantic search and retrieval, and agents can pull context on demand through tools, but no index or vector store that Pydantic AI maintains over the customer's documents is documented, so retrieval is assembled per run by the developer; web search and web fetch reach the public web, not the customer's knowledge. SourcePydantic AI, pydantic.dev/docs/ai/guides/embeddings and llms.txtread 2026-09-21 |
|
| Human Oversight & Guardrails | Full |
|
Deferred tools let a developer require approval before specific tool calls run, with the condition able to depend on the call's arguments, the conversation history or user preferences, and the Harness guardrails capability validates the prompt, tool calls and output with allow and block rules, so low and high risk actions can run under different autonomy modes. SourcePydantic AI, pydantic.dev/docs/ai/tools-toolsets/deferred-tools and harness/guardrailsread 2026-09-21 |
|
| Security, Identity & Governance | Partial |
|
The framework is a library with no hosted service or user layer; its documented controls are least-privilege tool access, through a FileSystem capability scoped to one directory tree with symlink-safe containment and a Shell capability with allow and deny controls and environment scrubbing. No supported identity providers or provisioning standards are documented, and no attestation covers the framework. SourcePydantic AI, pydantic.dev/docs/ai/harness/filesystem and harness/shellread 2026-09-21 |
|
| Observability & Auditability | Partial |
|
Built-in OpenTelemetry instrumentation records model calls and tool invocations as spans that flow to any OpenTelemetry backend the customer runs, so each step can be inspected. The trace store and views are the customer's chosen backend or the separately sold Pydantic Logfire, and the framework documents no audit log separate from runtime traces and no retention by plan. SourcePydantic AI, pydantic.dev/docs/ai/capabilities/instrumentation and integrations/logfireread 2026-09-21 |
|
| Memory & State Persistence | Full |
|
The Harness Memory capability gives each agent a persistent notebook of Markdown files it writes, reads, searches and deletes across runs, in a namespace resolved by application code so the model cannot reach another user's memory, with stores whose lifetime is stated, from process lifetime in memory to persistent file and SQLite stores; durable execution separately preserves run state across restarts. SourcePydantic AI, pydantic.dev/docs/ai/harness/memoryread 2026-09-21 |
|
| Deployment & Data Residency | Full |
|
The agent runtime is an open source library that runs wherever the customer runs Python, with durable execution on backends the customer operates such as Temporal, DBOS and Prefect, so agent data stays on the customer's infrastructure. SourcePydantic AI, pydantic.dev/docs/ai overview and durable execution pagesread 2026-09-21 |
|
| Prebuilt Agents, Templates & Packs | Full |
|
Pydantic AI Harness ships complete agents alongside its capabilities: Coder, an autonomous coding harness with six tools and context management, and Researcher, a complete web-research harness that returns source-backed answers. Each does its own job without the other; the 30-plus capabilities themselves are parts the developer assembles. SourcePydantic AI, pydantic.dev/docs/ai/harnessread 2026-09-21 |
|
| Triggers & Channel Coverage | Partial |
|
Event driven workflows and UI event stream standards are supported with token by token streaming for interactive applications, but as a library the triggering surface and channel coverage are the host application's responsibility; no scheduler, webhook framework or channel matrix ships with the framework. Sourcepydantic.dev/docs/ai/harness/gh-awread 2026-09-21 |
|
| Model Flexibility & Routing | Full |
|
The developer chooses the model for each agent from a provider catalog that Pydantic AI describes as covering every model, with a documented path for custom models, and the Pydantic AI Gateway offers single-key access across providers or bring-your-own-key, so model choice sits with the customer. SourcePydantic AI, pydantic.dev/docs/ai overview and overview/gatewayread 2026-09-21 |
|
| APIs, SDKs & MCP Extensibility | Full |
|
Pydantic AI is an open source Python SDK developed in the open, with a documented public interface, a capability system for building and publishing custom capabilities, and agents that can be served to other systems over Agent2Agent and to editors over the Agent Client Protocol. SourcePydantic AI, pydantic.dev/docs/ai overview, capabilities and harness/acp pagesread 2026-09-21 |
|
| Testing, Debugging & Optimization | Full |
|
Pydantic Evals is a shipped, customer facing evaluation product rather than internal vendor tooling: create datasets, run evaluations, systematically test the performance and accuracy of the agentic systems you build, and track model performance over time from the CLI or visualized in Logfire, with the evaluation workflow integrated into the same OpenTelemetry trace as production runs. Sourcepydantic.dev/docs/ai/evals/evalsread 2026-09-21 |
|
| Browser & Computer Use | Full |
|
The Harness Playwright Browser capability gives an agent a real, stateful Chromium browser through async Playwright that it drives itself, navigating, clicking, typing, scrolling and extracting page text, with no separate account required; that is documented control of a real browser. SourcePydantic AI, pydantic.dev/docs/ai/harness/playwrightread 2026-09-21 |
|
The Agentic Index coverage score grades every vendor Full, Partial or Not documented against the same 14 buyer facing capabilities, from public evidence only. Each capability links to how all vendors in the index score on it. How this evidence is graded
Recent platform changes
Pydantic AI v2.53.0 adds ToolCallJudge, which puts a second model in front of selected tool calls and asks it one risk question before the tool runs. A yes blocks the call and the agent gets a denial, a no lets it run, and an unsure answer can block, allow or turn into a request for human approval.
Bears on: Human approval / guardrails
View sourcePydantic AI added image generation, so agents built with the framework can generate images directly.
Bears on: Agent capability
View sourcePydantic AI released version 2.20.0, introducing native support for the Claude Opus 5 and GPT-5.6 models. The update adds explicit prompt caching for GPT-5.6, reasoning context support for the broader GPT-5.x family, and enables DynamicCapability toolsets in durable execution workflows via DBOS and Prefect.
Bears on: Agent capability
View sourcePricing
Free / OSS
usage
Included quota
Framework: open source, no quota and no license fee.
What is public
Pydantic AI is a free, open source Python agent framework that works with the customer's own model provider keys. Pydantic Logfire and the Pydantic AI Gateway are sold separately and are not priced here.
Billing mechanics
No billing for the open source framework; model provider usage is billed by the provider or through the separately sold Pydantic AI Gateway.
Cost watchouts
The framework is free; model provider tokens are the customer's own cost. Pydantic Logfire, the company's observability product, and the Pydantic AI Gateway are separate products with their own pricing.
Variable cost rationale
Framework cost is pure pass-through model tokens (zero floor); Logfire adds seat + volume-based fees with a configurable spend cap, so exposure is bounded if you set the cap
Additional watchouts
The framework has no vendor cost; tracing views, managed prompts and gateway routing sit in separately priced Pydantic products.
Overage / add-ons
Framework: none (you pay your model provider directly). Logfire: $2 per million records beyond the included volume, with a configurable spend cap to avoid surprises.
Sales call required
No, self serve available
Free / trial
Free (OSS self-host)
Commercial notes
Pydantic AI is the open source agent framework from the Pydantic team; Pydantic Logfire, an observability platform, is the company's separately sold commercial product.
Key ambiguities
None on the framework. Pydantic Logfire plan prices were removed from this row on 2026-09-21 because they price a different product.
Cancellation / refund
Framework: nothing to cancel (OSS). Logfire: self-serve Personal/Team/Growth with configurable spend caps; Enterprise on custom terms (SLA, self-host)
Support SLA / resale
Community support for the open source framework.
Missing data
Not applicable for the framework (free OSS); Logfire Enterprise pricing is custom (contact sales)
Related vendors
- AgentOps — Agent observability and debugging platform: open source SDKs trace…
- Agno — Python agent framework and AgentOS runtime (formerly Phidata) for…
- AIsa — Resource and payment gateway for AI agents: one key to 110+ models…
- AlphaBitCore — AI control plane for regulated financial firms: one gateway enforces…
- Anchor Browser — Cloud hosted browser infrastructure that lets AI agents operate real…
- Apify — Cloud platform and marketplace of more than 73,000 ready-to-run…
Alternatives to Pydantic AI
The closest documented capability profiles to Pydantic AI among agent infrastructure platforms tracked by Agentic Index, ordered by similarity on the same 14 point evidence the rankings use. No vendor pays for placement.
- LangChain11.5 / 14Fuller documented coverage on Knowledge Grounding & RAGPydantic AI vs LangChain →
- LlamaIndex12.0 / 14Fuller documented coverage on Knowledge Grounding & RAG and Security, Identity & GovernancePydantic AI vs LlamaIndex →
- Mastra14.0 / 14Fuller documented coverage on Knowledge Grounding & RAG and Security, Identity & Governance
- Pipecat10.5 / 14Fuller documented coverage on Observability & Auditability
- Agno13.0 / 14Fuller documented coverage on Knowledge Grounding & RAG and Security, Identity & GovernancePydantic AI vs Agno →
- Anchor Browser11.0 / 14Fuller documented coverage on Security, Identity & Governance and Observability & Auditability
Similarity is computed from each vendor's Agentic Index coverage score evidence, axis by axis, not from the totals. How this evidence is graded