← all repositories
vstorm-co/pydantic-deepagents

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.

★1.1k stars Python AgentsCoding Assistants
pydantic-deepagents
Velocity · 7d
+0.6
★ / day
Trend
↘cooling
star history

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 /improve command 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 run mode 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.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.