A self-hosted Claude Code that isn't chained to Anthropic
Pydantic Deep Agents packages the whole coding-agent harness — tools, memory, sandbox, subagents — on Pydantic AI, so any tool-calling model can drive it.

What it does
It’s two things in one repo: a terminal AI assistant in the Claude Code mold, and the Python framework underneath it. The CLI gives you streaming chat, file editing, shell execution, web search, browser automation via Playwright, and a Docker sandbox with named workspaces. The framework side exposes all of that through a single create_deep_agent() call where every capability — subagents, skills, memory, checkpoints, cost tracking — is a boolean toggle.
The interesting bit
The harness treats the boring failure modes as first-class features: stuck-loop detection (including A-B-A-B tool-call patterns), context-limit warnings pushed to the model at 70% token usage before auto-compression kicks in at 90%, and hard budget limits that raise BudgetExceededError. That’s the plumbing most homegrown agents quietly lack.
Key highlights
- Works with any tool-calling model: Anthropic, OpenAI, OpenRouter, Gemini, Ollama for local, or any OpenAI-compatible endpoint
- Persistent memory via
MEMORY.md, auto-injected into the system prompt, with a/improvecommand that proposes updates from past sessions - Multi-agent teams with shared TODO lists, claiming, and a peer-to-peer message bus
- Checkpoints let you rewind or fork a session to explore alternative approaches
- Headless
runmode with JSON output for CI and benchmarks, plus a Harbor adapter for Terminal Bench - Claims 100% test coverage and strict Pyright/Mypy typing throughout
Caveats
- The feature list is long, and the README doesn’t say how much of it is battle-tested versus recently shipped — several headline features arrived in the v0.3.x series within weeks of each other.
- Docker sandbox and browser automation are opt-in extras, so the out-of-the-box experience is narrower than the table suggests.
Verdict
Worth a look if you want Claude Code ergonomics with model freedom, or a typed Python base for building your own deep agents. If you’re happy with the vendor’s own CLI and don’t need the framework layer, there’s less here for you.
Frequently asked
- What is vstorm-co/pydantic-deepagents?
- Pydantic Deep Agents packages the whole coding-agent harness — tools, memory, sandbox, subagents — on Pydantic AI, so any tool-calling model can drive it.
- Is pydantic-deepagents open source?
- Yes — vstorm-co/pydantic-deepagents is open source, released under the MIT license.
- What language is pydantic-deepagents written in?
- vstorm-co/pydantic-deepagents is primarily written in Python.
- How popular is pydantic-deepagents?
- vstorm-co/pydantic-deepagents has 1.1k stars on GitHub and is currently cooling off.
- Where can I find pydantic-deepagents?
- vstorm-co/pydantic-deepagents is on GitHub at https://github.com/vstorm-co/pydantic-deepagents.