跳过内容

安装

PydanticAI 可以在 PyPI 上以 pydantic-ai 获取，因此安装非常简单：

pip install pydantic-ai

uv add pydantic-ai

(需要Python 3.9以上版本)

这将安装 pydantic_ai 包、核心依赖项和使用 PydanticAI 中所有模型所需的库。如果您想使用特定模型，可以安装 PydanticAI 的 "slim" 版本。

与 PydanticAI Logfire 一起使用

PydanticAI 具有出色的（但完全可选的）集成与 Pydantic Logfire，帮助您查看和理解代理运行。

要将Logfire与PydanticAI一起使用，请安装 pydantic-ai 或 pydantic-ai-slim，并使用 logfire 可选组：

pip install 'pydantic-ai[logfire]'

uv add 'pydantic-ai[logfire]'

接下来，按照 Logfire setup docs 配置 Logfire。

运行示例

我们将 pydantic_ai_examples 目录作为一个独立的 PyPI 包 (pydantic-ai-examples) 进行分发，以便于用户极其简单地自定义和运行示例。

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

pip install 'pydantic-ai[examples]'

uv add 'pydantic-ai[examples]'

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

精简安装

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

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

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

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

请查看models文档，以获取每个模型所需的可选依赖项的信息。

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

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

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