vstorm-co/pydantic-deepagents

这是什么？

核心功能

• 01终端界面支持文件编辑、shell 执行、网页搜索抓取以及 MCP 服务器接入
• 02运行中分叉功能，将任务拆成多个分支，由 AI 评审或测试结果决定保留哪一个
• 03框架入口 create_deep_agent() 可开关任务规划、子智能体、记忆和技能等模块
• 04基于 Docker 的沙箱，支持命名工作区，并可通过 Playwright 进行浏览器自动化
• 05长对话自动摘要压缩，主模型失败时可切换备用模型重试
• 06检查点功能可保存、回退和分叉会话

适用场景

• 部署一个自托管的编程助手，并自由选择所用模型
• 在现成的智能体框架之上构建自定义的研究或编程智能体
• 并行尝试多种实现方案，保留通过测试的那一个
• 在 CI 或脚本中通过无界面的 run 命令自动执行编程任务

快速上手

1. 1

   在 Windows 或手动安装 CLI（使用 pip）

   pip install "pydantic-deep[cli]"
2. 2

   在终端中运行该助手

   pydantic-deep

使用前须知

• !需要 Python 3.10 或更高版本。
• !Linux 和 macOS 上的一键安装脚本需要按 README 手动运行。

收录于专题

标签

常见问题

pydantic-deepagents 是什么？

可自托管的开源终端 AI 助手，同时提供其底层 Python 框架，基于 Pydantic AI，可接入任意模型。 Pydantic Deep Agents 是一个类似 Claude Code 的终端 AI 助手，同时也是用于构建同类智能体的 Python 框架。命令行版本可以规划任务、读写和编辑文件、执行 shell 命令、搜索和抓取网页、跨会话保存记忆、派生子智能体，并连接 MCP 服务器。同一套底层能力也可以通过调用 create_deep_agent() 一行创建，为任意模型提供文件系统、shell、任务规划、记忆、沙箱执行和上下文自动摘要。

pydantic-deepagents 可以免费使用吗？用的什么许可证？

pydantic-deepagents 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

pydantic-deepagents 还在维护吗？

活跃维护中。pydantic-deepagents 最近一次提交是在 2026年10月30日。

pydantic-deepagents 适合用来做什么？

部署一个自托管的编程助手，并自由选择所用模型 在现成的智能体框架之上构建自定义的研究或编程智能体 并行尝试多种实现方案，保留通过测试的那一个 在 CI 或脚本中通过无界面的 run 命令自动执行编程任务

pydantic-deepagents 怎么安装和运行？

在 Windows 或手动安装 CLI（使用 pip）: pip install "pydantic-deep[cli]" 在终端中运行该助手: pydantic-deep

在哪里获取 pydantic-deepagents？

源代码和安装说明在 GitHub 上：https://github.com/vstorm-co/pydantic-deepagents