vstorm-co/pydantic-deepagents

Open-source, self-hosted Claude Code - a terminal AI assistant and the Python framework behind it. Tool-calling, sandboxed execution, multi-agent teams, skills, checkpoints, unlimited context - on Pydantic AI, any model.

What it solves

Pydantic Deep Agents 提供一套完整的基础设施（“agent harness”）用于构建和运行自主 AI 代理。它消除了开发者手动实现重复性“管道”工作（如工具调用、记忆、沙盒执行和上下文管理）的需求，同时提供一个自托管的终端助手，作为 Claude Code 的即用型替代方案。

How it works

基于 Pydantic AI，项目同时作为 CLI 工具和 Python 框架运行。它将 LLM 包装在一系列能力中，包括用于隔离执行的 copy‑on‑write 文件系统、多代理群体架构用于任务委派，以及持久化记忆系统。突出特性是“Live Run Forking”，允许代理将单次执行分支为多条并行路径以测试不同方法，由 AI 判官或测试结果决定获胜分支并合并回主历史。

Who it’s for

  • Developers 想要一个类型安全的 Python 框架，快速构建复杂的研究或编码代理。
  • Power users 需要一个自托管、模型无关的终端 AI 助手，能够编辑文件、运行 shell 命令，并连接 MCP 服务器。

Highlights

  • Live Run Forking：通过隔离分支和自动合并实现代理决策的并行化。
  • Model Agnostic：支持 Anthropic、OpenAI、Google Gemini、OpenRouter，以及通过 Ollama 的本地模型。
  • Agent Harness：集成网页搜索、浏览器自动化（Playwright）和本地文档解析（PDF、DOCX 等）工具。
  • Sandboxed Execution：基于 Docker 的工作空间，确保代码安全执行。
  • MCP Integration：原生支持 Model Context Protocol 服务器（如 GitHub、Figma）。
  • Type Safety：使用 Pydantic 的完整类型化公共 API，提供结构化输出和 IDE 自动完成。