Skip to main content
pydantic-deepagents is a Claude Code–style deep agent harness built on pydantic-ai. It uses pydantic-ai-backend’s SandboxProtocol for filesystem, shell, grep, and edit operations, Mirage’s PydanticAIWorkspace is a drop-in implementation of that protocol.

Install

This pulls in pydantic-ai>=1.35 and pydantic-ai-backend>=0.1.0. To use it with pydantic-deepagents:

Usage

Exports

PydanticAIWorkspace routes file operations through the Ops layer directly and shell operations through Workspace.execute() for full pipe and flag support. PDF reads are converted to images via pages_to_images so the agent can pass them as BinaryContent.

Examples