OpenInference PydanticAI

Python auto-instrumentation library for PydanticAI. These traces are fully OpenTelemetry compatible and can be sent to an OpenTelemetry collector for viewing, such as Arize Phoenix or Arize AX.

Installation

pip install openinference-instrumentation-pydantic-ai

Requires Pydantic AI 2.24.0 or newer.

Quickstart

This quickstart shows you how to instrument your PydanticAI agents.

Install required packages.

pip install "pydantic-ai>=2.24.0" arize-phoenix opentelemetry-sdk opentelemetry-exporter-otlp

Start Phoenix in the background as a collector. By default, it listens on http://localhost:6006. You can visit the app via a browser at the same address. (Phoenix does not send data over the internet. It only operates locally on your machine.)

phoenix serve

Here's a simple example that demonstrates how to use PydanticAI with OpenInference instrumentation:

import os
from pydantic import BaseModel
from pydantic_ai import Agent
from pydantic_ai.models.instrumented import InstrumentationSettings
from pydantic_ai.models.openai import OpenAIModel
from pydantic_ai.providers.openai import OpenAIProvider
from opentelemetry import trace
from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter
from opentelemetry.sdk.trace import TracerProvider
from openinference.instrumentation.pydantic_ai import OpenInferenceSpanProcessor
from opentelemetry.sdk.trace.export import SimpleSpanProcessor

# Set your OpenAI API key
os.environ["OPENAI_API_KEY"] = "YOUR_OPENAI_API_KEY"

# Set up the tracer provider
tracer_provider = TracerProvider()
trace.set_tracer_provider(tracer_provider)

# Add the OpenInference span processor
endpoint = "http://127.0.0.1:6006/v1/traces"
exporter = OTLPSpanExporter(endpoint=endpoint)
tracer_provider.add_span_processor(OpenInferenceSpanProcessor())
tracer_provider.add_span_processor(SimpleSpanProcessor(exporter))


# Define your Pydantic model
class LocationModel(BaseModel):
    city: str
    country: str

instrumentation = InstrumentationSettings(version=2)

# Create and configure the agent
model = OpenAIModel("gpt-4", provider=OpenAIProvider())
agent = Agent(model, output_type=LocationModel, instrument=instrumentation)

# Run the agent
result = agent.run_sync("The windy city in the US of A.")
print(result)

This example:

Sets up OpenTelemetry tracing with Phoenix
Defines a simple Pydantic model for location data
Creates a PydanticAI agent with instrumentation enabled
Runs a query and gets structured output

The traces will be visible in the Phoenix UI at http://localhost:6006.

More Info

Metadata

Release files for openinference-instrumentation-pydantic-ai 0.1.28

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for openinference-instrumentation-pydantic-ai 0.1.28
File	Size	Uploaded
openinference_instrumentation_pydantic_ai-0.1.28.tar.gz	25.4 kB	Oct 1, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for openinference-instrumentation-pydantic-ai 0.1.28
File	Interpreter	ABI	Platform	Reset
openinference_instrumentation_pydantic_ai-0.1.28-py3-none-any.whl 17.7 kB Oct 1, 2026	Python 3	none	any	Details

Total release size: 43.1 kB

Release files / openinference_instrumentation_pydantic_ai-0.1.28.tar.gz

Download URL	openinference_instrumentation_pydantic_ai-0.1.28.tar.gz
Size	25.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`0428c2d4081d8cedc32e1adad2fdd7205be79f34ca0cfa66e7478498a41eacf8`
BLAKE2b-256 checksum How to use checksums	`53b0317533b15199279eb8b926392a8daee8d63d512e6f19da855ff0ad9d94e9`
Upload date	Oct 1, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Arize-ai/openinference
Publishing commit: github.com/Arize-ai/openinference/tree/32714fda1578a088b6237968f4945e8a826dae92

Workflow

Publishing configuration: github.com/Arize-ai/openinference/blob/32714fda1578a088b6237968f4945e8a826dae92/.github/workflows/publish.yaml
Publishing logs: github.com/Arize-ai/openinference/actions/runs/36806322558/attempts/1

Artifact

Subject: openinference_instrumentation_pydantic_ai-0.1.28.tar.gz
SHA-256 checksum: 0428c2d4081d8cedc32e1adad2fdd7205be79f34ca0cfa66e7478498a41eacf8 Verifying attestations

Release files / openinference_instrumentation_pydantic_ai-0.1.28-py3-none-any.whl

Download URL	openinference_instrumentation_pydantic_ai-0.1.28-py3-none-any.whl
Size	17.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`26e36f7fe3c748f87bbc3c73eb31738d11ca8aa12f099f1ab7ac22911d63b9e2`
BLAKE2b-256 checksum How to use checksums	`bc574d5b8b0f9f4aecc25e03505c20c975a90b4b0e2a8b04b9501aea4fecc857`
Upload date	Oct 1, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Arize-ai/openinference
Publishing commit: github.com/Arize-ai/openinference/tree/32714fda1578a088b6237968f4945e8a826dae92

Workflow

Publishing configuration: github.com/Arize-ai/openinference/blob/32714fda1578a088b6237968f4945e8a826dae92/.github/workflows/publish.yaml
Publishing logs: github.com/Arize-ai/openinference/actions/runs/36806322558/attempts/1

Artifact

Subject: openinference_instrumentation_pydantic_ai-0.1.28-py3-none-any.whl
SHA-256 checksum: 26e36f7fe3c748f87bbc3c73eb31738d11ca8aa12f099f1ab7ac22911d63b9e2 Verifying attestations