Agent Atlas / Agent frameworks

pydantic/pydantic-ai

A Python agent framework organized around typed dependencies, structured outputs, tools, model providers, durable execution, evaluation, and observability.

Agent framework Scope profile Project documented Reviewed August 26, 2026
Intended operator

Python developers building typed agent applications.

Primary surfaces

Python library / typed agent and tool APIs / evaluation and observability integrations

Tracked repository

pydantic/pydantic-ai

Teaching mechanism

Types can make model output and tool contracts explicit

The framework presents agent dependencies, tool inputs, and structured results through Python types and validation boundaries.

Evidence limitTyped validation narrows representation errors; it does not prove semantic correctness or safe execution.
Inspect the source
System map status

Reporting is still in progress.

This scope profile names the project's place in the field and one useful mechanism. It does not claim that every runtime boundary has been inspected.

Learn Through This Project

7 lessons
Chapter 1 Before the First Model Request Chapter 3 Tool Calls: Contract, Authorization, Execution Chapter 4 Loops, Workflows, and Recovery Chapter 5 Delegation Is a Distributed System Chapter 6 Memory Is a Typed Storage Contract Chapter 9 Trust Must Make Its Case Chapter 10 The Future Has Three Branches

Compare Its Boundaries

6 labs
Comparison labTool ContractsComparison labGoverned MemoryComparison labDelegation ReceiptsComparison labSessions And RecoveryComparison labEvidence And EvaluationComparison labMaturity Signals

Latest Reporting

6 articles
API Discovery: Let an Agent Notice When Its Reasoning Was Dropped

September 3, 2026 — Pydantic AI now carries an Anthropic thinking-block fallback through later turns—but the useful operator move is to expose the loss, then fix the unstable prompt prefix that caused it. pydantic/pydantic-ai

 API Discovery: Tool Calls Need a Home in the Stream

August 30, 2026 — Pydantic AI’s public AG-UI adapter now gives a tool-only response an announced assistant-message parent—useful when a frontend rebuilds a conversation from streamed events. pydantic/pydantic-ai

 API Discovery: Pydantic AI routes Cortex work through Snowflake

August 9, 2026 — Pydantic AI now has a Snowflake Cortex provider, but a useful trial starts by checking the selected model’s capability boundary—not by assuming one adapter makes every model equivalent. pydantic/pydantic-ai

 A green check is not proof an agent ran

August 3, 2026 — Pydantic AI turned several ways a coding-agent workflow can silently do nothing into tested policy checks. The transferable craft is to test the execution graph, not just the agent prompt. pydantic/pydantic-ai

 The Harness Was Taking the Test Too

July 30, 2026 — OpenAI says two context choices lifted GPT-5.6 Sol from 13.3% to 38.3% on the ARC-AGI-3 public set. Codex source shows those “settings” are really a production memory system—and rival harnesses reveal how much of it can be copied. openai/codex, pydantic/pydantic-ai, earendil-works/pi, NousResearch/hermes-agent, mistralai/mistral-vibe, anomalyco/opencode, QwenLM/qwen-code, google-gemini/gemini-cli, cline/cline, aaif-goose/goose, OpenHands/OpenHands

 PydanticAI: what type safety means when agents can act

July 28, 2026 — A fresh cancellation fix draws the line clearly: typed inputs and validated outputs can discipline an agent’s interface, but a long-running run still needs a truthful answer to one operational question—did it actually stop? pydantic/pydantic-ai

Primary Sources

Pydantic AI repository

Primary public framework source.

Open Questions

  • Which guarantees are truly enforced by types, and which still depend on application policy and runtime authority?

Evidence state describes what this Atlas profile can support today. It is not a product score and it is not evidence that uninspected capabilities are absent.