跳到内容

安装

PydanticAI 在 PyPI 上以 pydantic-ai 提供，因此安装非常简单，只需

pip install pydantic-ai

uv add pydantic-ai

（需要 Python 3.9+）

这将安装 pydantic_ai 包、核心依赖项以及使用 PydanticAI 中包含的所有模型所需的库。如果您想使用特定模型，您可以安装 “精简” 版本的 PydanticAI。

与 Pydantic Logfire 一起使用

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

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

pip install "pydantic-ai[logfire]"

uv add "pydantic-ai[logfire]"

从那里，按照 Logfire 设置文档 配置 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 具有以下可选组

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

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

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

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