pydantic-deepagents

(★ 1,038)

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.

파일 탐색기

최종 버전 다운로드 (.zip)

- - bug_report.yml
  - config.yml
  - feature_request.yml
- - add-to-project.yml
  - ci.yml
  - docs.yml
  - publish.yml
  - uv-lock-sync.yml
- pull_request_template.md
- - __init__.py
  - __main__.py
  - README.md
  - server.py
- - __init__.py
  - agent.py
  - app.py
  - clipboard_image.py
  - commands.py
  - config.py
  - credentials.py
  - debug_log.py
  - forking.py
  - fuzzy.py
  - goal.py
  - init.py
  - interactive.py
  - keys_cmd.py
  - keystore.py
  - known_models.py
  - local_context.py
  - main.py
  - mcp_store.py
  - messages.py
  - model_history.py
  - model_resolve.py
  - onboarding_cli.py
  - openrouter_models.py
  - PRODUCT_REPORT.md
  - prompts.py
  - providers.py
  - reminder.py
  - run.py
  - text_heuristics.py
  - tips.py
  - tui.py
  - update.py
- - .dockerignore
  - .env.example
  - docker-compose.yml
  - Dockerfile
  - pyproject.toml
  - README.md
- - __init__.py
  - agent.py
  - AGENTS.md
  - README.md
- baner.png
- cli.png
- cli_demo.gif
- cli_demo_v2.gif
- display_files_deepresearch.png
- excalidraw.gif
- excalidraw_in_deepresearch.png
- img.png
- planner_asks_question.png
- report.gif
- social-preview.png
- social-preview.svg
- spawn_subagents_deepresearch.png
- zed.png
- - agent-spec.md
  - browser.md
  - capabilities.md
  - context-management.md
  - cost-tracking.md
  - fallback-models.md
  - forking.md
  - goal.md
  - hooks.md
  - index.md
  - liteparse.md
  - message-queue.md
  - monitor.md
  - multi-user.md
  - output-styles.md
  - periodic-reminder.md
  - plan-mode.md
  - stuck-loop-detection.md
  - teams.md
- - agent.md
  - backends.md
  - capabilities.md
  - checkpointing.md
  - context-files.md
  - forking.md
  - goal.md
  - hooks.md
  - index.md
  - mcp.md
  - memory.md
  - message-queue.md
  - monitoring.md
  - output-styles.md
  - processors.md
  - spec.md
  - teams.md
  - tool-search.md
  - toolsets.md
  - types.md
- - acp.md
  - deepresearch.md
  - harbor.md
  - index.md
- - memory-and-context.md
- - logo.svg
- - 1-project-overview.md
  - 2-architecture-overview.md
  - 3-workflow-overview.md
  - 4a-deep-dive-agent-factory.md
  - 4b-deep-dive-toolsets-and-capabilities.md
- - commands.md
  - getting-started.md
  - index.md
  - keybindings.md
  - sessions-forking-mcp.md
  - settings.md
- - agents.md
  - backends.md
  - index.md
  - skills.md
  - toolsets.md
- - basic-usage.md
  - composite-backend.md
  - custom-tools.md
  - docker-runtimes.md
  - docker-sandbox.md
  - file-uploads.md
  - filesystem.md
  - full-app.md
  - human-in-the-loop.md
  - index.md
  - interactive-chat.md
  - mcp.md
  - skills.md
  - streaming.md
  - subagents.md
  - thinking.md
  - web-tools.md
- - abbreviations.md
- - extra.js
- - custom-tools.md
  - files-and-shell.md
  - first-agent.md
  - human-in-the-loop.md
  - index.md
  - memory.md
  - planning.md
  - sessions.md
  - skills.md
  - streaming.md
  - structured-output.md
  - subagents.md
  - web-and-mcp.md
- - main.html
- - extra.css
- contributing.md
- favicon.ico
- getting-help.md
- index.md
- installation.md
- - app.py
  - audit_middleware.py
  - github_tools.py
  - README.md
  - TESTING.md
- - main.py
  - README.md
- basic_usage.py
- composite_backend.py
- custom_tools.py
- docker_sandbox.py
- file_uploads.py
- filesystem_backend.py
- human_in_the_loop.py
- interactive_chat.py
- mcp_server.py
- skills_usage.py
- streaming.py
- subagents.py
- thinking.py
- web_tools.py
- - __init__.py
- - __init__.py
  - builtins.py
  - config.py
  - loader.py
  - registry.py
  - resources.py
- - __init__.py
  - builder.py
  - fragments.py
- __init__.py
- _text.py
- agent.py
- deps.py
- goal.py
- instructions.py
- models.py
- spec.py
- styles.py
- subagents.py
- types.py
- __init__.py
- conftest.py
- test_agent.py
- test_agent_extended.py
- test_browser.py
- test_capabilities.py
- test_checkpointing.py
- test_cli_agent.py
- test_cli_assistant_message.py
- test_cli_clipboard_image.py
- test_cli_command_coverage.py
- test_cli_commands.py
- test_cli_config.py
- test_cli_credentials.py
- test_cli_diff_view.py
- test_cli_dispatch.py
- test_cli_fuzzy.py
- test_cli_goal.py
- test_cli_history_picker.py
- test_cli_image_paste.py
- test_cli_local_context.py
- test_cli_local_models.py
- test_cli_mcp.py
- test_cli_new_features.py
- test_cli_run.py
- test_cli_session_picker.py
- test_cli_settings.py
- test_cli_tool_call_widget.py
- test_cli_update.py
- test_context.py
- test_context_manager.py
- test_diff_picker_modal.py
- test_eviction.py
- test_fork_config_modal.py
- test_fork_picker_n_branches.py
- test_forking_branch_approval.py
- test_forking_budget.py
- test_forking_core.py
- test_forking_diff.py
- test_forking_editor.py
- test_forking_judge.py
- test_forking_materializer.py
- test_forking_merge_apply.py
- test_goal.py
- test_harbor_agent.py
- test_history_archive.py
- test_hooks.py
- test_improve.py
- test_instructions.py
- test_liteparse.py
- test_mcp.py
- test_mcp_loader.py
- test_mcp_resources.py
- test_memory.py
- test_message_queue.py
- test_model_picker.py
- test_monitoring.py
- test_patch_tool_calls.py
- test_periodic_reminder.py
- test_plan_toolset.py
- test_processors.py
- test_prompts.py
- test_public_api.py
- test_skills.py
- test_skills_backend.py
- test_skills_extended.py
- test_spec.py
- test_stuck_loop.py
- test_styles.py
- test_teams.py
- test_text.py
- test_tool_search.py
- test_toolsets.py
- test_toolsets_extended.py
- test_tui.py
- test_tui_extras.py
- test_tui_forking.py
- test_tui_forking_acceptance.py
- test_tui_judge_loading.py
.gitignore
.pre-commit-config.yaml
CHANGELOG.md
CLAUDE.md
CODE_QUALITY_REPORT.md
CONTRIBUTING.md
GOVERNANCE.md
install.sh
LICENSE
Makefile
mkdocs.yml
pyproject.toml
README.md
renovate.json
SECURITY.md
SYSTEM_REVIEW.md

🚀 설치 가이드

1. 코드 내려받기

git clone https://github.com/vstorm-co/pydantic-deepagents

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd pydantic-deepagents

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. 공식 설치 스크립트

쉬움 추천

사전 준비물

Python 3 pip 명령어를 쓰려면 Python이 필요합니다.

curl -fsSL https://raw.githubusercontent.com/vstorm-co/pydantic-deep/main/install.sh | bash

공식 설치 스크립트를 다운로드해서 바로 실행합니다. 이 한 줄로 필요한 게 자동으로 설치됩니다.

pip install pydantic-deep

PyPI에 배포된 패키지를 바로 설치합니다. 소스 클론이 필요 없습니다.

✅ 설치 후 새 터미널을 열고, 프로그램의 버전 확인 명령(예: --version)으로 정상 설치됐는지 확인하세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

3. Docker

쉬움

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Docker Desktop 컨테이너를 빌드하고 실행하려면 필요합니다. 설치 후 실행해서 백그라운드에 켜두세요.

pydantic-deep tui --sandbox docker

이 명령어를 터미널에 그대로 입력해 실행하세요.

이 명령어를 터미널에 그대로 입력해 실행하세요.

✅ 터미널에 docker compose ps 를 입력해 컨테이너들이 Up 상태인지 확인하세요. README에 포트 번호가 적혀있다면 브라우저에서 http://localhost:포트번호 로 접속해보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

4. Python

쉬움

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Python 3 설치 시 'Add Python to PATH' 옵션을 꼭 체크하세요 (Windows).

pip install pydantic-deep

PyPI에 배포된 패키지를 바로 설치합니다. 소스 클론이 필요 없습니다.

✅ 에러 메시지 없이 실행되고 터미널에 안내 문구가 출력되면 정상입니다.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

5. Make

보통

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Make Linux/macOS는 보통 기본 설치되어 있습니다. Windows는 별도 설치(예: MSYS2, WSL)가 필요합니다.

make install

생성된 빌드 설정을 바탕으로 실제 컴파일을 진행해 실행 파일을 만듭니다.

make test # 100% coverage required

생성된 빌드 설정을 바탕으로 실제 컴파일을 진행해 실행 파일을 만듭니다.

make all # lint + typecheck + test

생성된 빌드 설정을 바탕으로 실제 컴파일을 진행해 실행 파일을 만듭니다.

✅ 에러 없이 끝나면 성공입니다. 생성된 실행 파일을 직접 실행해보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.