Skip to main content
Pydantic AI agents can use pydantic-ai-backend’s SandboxProtocol for filesystem, shell, grep, and edit operations. Mirage’s PydanticAIWorkspace is a drop-in implementation of that protocol and also works with higher-level harnesses such as pydantic-deepagents.

Install

This pulls in pydantic-ai-slim[anthropic,openai]>=2.13.0 and pydantic-ai-backend>=0.2.16. 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. Enable image_support and document_support on the console toolset to pass images and PDFs from any Mirage mount to multimodal models as native BinaryContent.

Examples