跳转到内容

安装

Pydantic AI 已在 PyPI 上发布，包名为 pydantic-ai，因此安装非常简单：

pip install pydantic-ai

uv add pydantic-ai

（需要 Python 3.10+）

此命令将安装 pydantic_ai 包、核心依赖项以及使用 Pydantic AI 中包含的所有模型所需的库。如果你只想安装使用特定模型所需的依赖项，可以安装 Pydantic AI 的“精简”版本。

与 Pydantic Logfire 配合使用

Pydantic AI 与 Pydantic Logfire 有着出色（但完全可选）的集成，可以帮助你查看和理解代理（agent）的运行过程。

Logfire 已包含在 pydantic-ai 中（但不包含在“精简”版本中），因此你通常可以按照 Logfire 设置文档 的说明立即开始使用它。

运行示例

我们将 pydantic_ai_examples 目录作为一个单独的 PyPI 包 (pydantic-ai-examples) 发布，以便于轻松地自定义和运行示例。

要安装示例，请使用 examples 可选组：

pip install "pydantic-ai[examples]"

uv add "pydantic-ai[examples]"

要运行示例，请遵循示例文档中的说明。

精简安装

如果你知道要使用哪个模型，并希望避免安装多余的包，可以使用 pydantic-ai-slim 包。例如，如果你只使用 OpenAIChatModel，可以运行：

pip install "pydantic-ai-slim[openai]"

uv add "pydantic-ai-slim[openai]"

pydantic-ai-slim 具有以下可选组：

请参阅模型文档，了解每个模型需要哪些可选依赖项。

你也可以为多个模型和用例安装依赖项，例如：

pip install "pydantic-ai-slim[openai,vertexai,logfire]"

uv add "pydantic-ai-slim[openai,vertexai,logfire]"