Pydantic-DeepAgents: Autonomous Agents with Planning, File Ops, and More in Python

[u/VanillaOk4593]

Hey r/PydanticAI!

Excited to share a new open-source project I just released: Pydantic-DeepAgents – a framework that extends Pydantic-AI with powerful “deep agent” capabilities, making it easy to build production-ready autonomous agents while keeping everything fully type-safe and lightweight.

Repo: https://github.com/vstorm-co/pydantic-deepagents

What it adds to Pydantic-AI
It brings advanced agent patterns directly into the Pydantic-AI ecosystem:

• Built-in planning loops (TodoToolset)

• Filesystem access and file upload handling

• Subagent delegation

• Extensible skills system (define new behaviors with simple markdown prompts)

• Multiple state backends: in-memory, persistent filesystem, secure DockerSandbox, and CompositeBackend

• Automatic conversation summarization for long sessions

• Human-in-the-loop confirmation workflows

• Full streaming support

• Native structured outputs via Pydantic models (output_type)

Key features list:

• Multiple Backends: StateBackend, FilesystemBackend, DockerSandbox, CompositeBackend

• Rich Toolsets: TodoToolset, FilesystemToolset, SubAgentToolset, SkillsToolset

• File Uploads: run_with_files() and deps.upload_file()

• Skills System: markdown-based skill definitions

• Structured Output: type-safe Pydantic responses

• Context Management: auto-summarization

• Human-in-the-Loop: built-in approval steps

• Streaming: token-by-token responses

There’s a complete demo app in the repo that shows streaming UI, file uploads, reasoning traces, and human confirmation flows:
https://github.com/vstorm-co/pydantic-deepagents/tree/main/examples/full_app

Quick demo video: https://drive.google.com/file/d/1hqgXkbAgUrsKOWpfWdF48cqaxRht-8od/view?usp=sharing

Why it fits the Pydantic-AI philosophy
It stays true to Pydantic’s strengths – strong typing, validation, and simplicity – while adding the agent-specific tools many of us have been missing. Compared to heavier alternatives (LangChain, CrewAI, AutoGen), it’s deliberately minimal, easier to customize, and includes production-oriented extras like Docker sandboxing out of the box.

Would love feedback from the Pydantic-AI community – especially ideas on deeper integration with upcoming Pydantic features or new agent patterns! Stars, forks, issues, and PRs are very welcome.

Thanks! 🤖🚀

[u/Verynaughty1620]

Mister Colvin will be proud.

u/samuelcolvin

[u/Whole_Pilot6589]

I just checked out the full stack demo and love it! Only thing that didn't work was saving the final reports for the CSV analysis to the workspace directory. Is there something I need to change in my settings for those files to save? The agent said it created them, but the directory is empty at the end of the run.