pydantic-deepagents

环境要求

• macOS 或 Linux（可一键脚本安装）
• Windows 需手动用 pip 安装
• Python 3.10+（使用一键脚本则无需自行准备 Python 环境）
• 准备 Anthropic API Key（或其他模型密钥），用于调用模型
• 可选：Docker，用于沙箱隔离执行

安装与启动步骤

1. 1一键安装 CLI

   macOS / Linux 用户直接执行安装脚本，脚本会自动装好 uv 和 CLI，无需自行配置 Python 环境。

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

   复制

2. 2Windows 手动安装

   Windows 或想手动安装的用户改用 pip 安装带 CLI 扩展的包，注意包名带 [cli]。

   pip install "pydantic-deep[cli]"

   复制

3. 3配置模型密钥

   把 Anthropic API Key 写入环境变量，脚本运行需要读取该变量，请替换成自己的真实 Key。

   export ANTHROPIC_API_KEY=sk-ant-xxxxxxxx

   复制

4. 4启动终端助手

   直接运行 pydantic-deep 即可进入交互式终端 AI 助手，用自然语言完成编码等任务。

   pydantic-deep

   复制

5. 5用 Docker 沙箱运行

   加上 --sandbox docker 参数启用沙箱执行，当前项目目录会被挂载到容器内 /workspace。

   pydantic-deep tui --sandbox docker

   复制

6. 6使用命名工作区

   加 --workspace 指定命名工作区，安装的依赖包会在该工作区内持久保留。

   pydantic-deep tui --workspace ml-env

   复制

关键配置

如何确认成功

执行 pydantic-deep 后能正常进入交互界面、且没有 API Key 缺失报错，即表示启动成功。

常见问题

注意事项

• 一键安装脚本目前只覆盖 macOS 和 Linux，Windows 需手动 pip 安装。
• Docker 沙箱模式下项目目录挂载在 /workspace，注意路径映射。
• 除终端助手外，它还是可 Import 的 Python 框架，可用 create_deep_agent 构建自定义 Agent。
• 项目为 MIT 许可，支持接入任意模型，具体模型配置请查阅官方文档。