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을 격리 실행을 위한 copy‑on‑write 파일 시스템, 작업 위임을 위한 멀티‑에이전트 스웜 아키텍처, 영구 메모리 시스템 등 다양한 기능으로 래핑합니다. 눈에 띄는 특징은 “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: 구조화된 출력과 IDE 자동 완성을 제공하는 Pydantic 기반 완전 타입 지정 공개 API.