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 は、自治的 AI エージェントを構築・実行するための包括的なインフラストラクチャ（「エージェントハーネス」）を提供します。ツール呼び出し、メモリ、サンドボックス実行、コンテキスト管理といった繰り返しの「配管」作業を開発者が手動で実装する必要がなくなり、Claude Code の代替としてすぐに使えるセルフホスト型ターミナルアシスタントも提供します。

How it works

Pydantic AI を基盤とし、本プロジェクトは CLI ツール兼 Python フレームワークとして動作します。LLM をコピーオンライトファイルシステムによる分離実行、タスク委任用のマルチエージェントスウォームアーキテクチャ、永続メモリシステムといった機能群でラップします。特筆すべきは「Live Run Forking」機能で、エージェントが単一の実行を複数の平行パスに分岐させ、異なるアプローチをテストでき、AI ジャッジまたはテスト結果で勝者ブランチを選び、メイン履歴にマージします。

Who it’s for

  • Developers 型安全な Python フレームワークで、複雑な研究・コーディングエージェントを迅速に構築したい方。
  • Power users セルフホストでモデル非依存のターミナル AI アシスタントを求め、ファイル編集、シェルコマンド実行、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 のオートコンプリートを実現。