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 提供一套完整的基礎建設（「代理 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 自動完成。