OpenInference Agno Instrumentation
Python auto-instrumentation library for Agno Agents
The following instrumentation is fully OpenTelemetry-compatible and can be sent to an OpenTelemetry collector for monitoring, such as Arize Phoenix, Arize AX, or Langfuse.
Installation
pip install openinference-instrumentation-agno
Quickstart
This quickstart shows you how to instrument your Agno Agent application.
You've already installed openinference-instrumentation-agno. Next is to install packages for agno,
Phoenix and opentelemetry-instrument, which exports traces to it.
pip install agno arize-phoenix opentelemetry-sdk opentelemetry-exporter-otlp-proto-grpc opentelemetry-distro
Start the Phoenix app in the background as a collector:
phoenix serve
By default, it listens on http://localhost:6006. You can visit the app via a browser at the same address.
The Phoenix app does not send data over the internet. It only operates locally on your machine.
Create a simple Agno agent:
from agno.agent import Agent
from agno.models.openai import OpenAIChat
from agno.tools.duckduckgo import DuckDuckGoTools
from openinference.instrumentation.agno import AgnoInstrumentor
from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter
from opentelemetry.sdk import trace as trace_sdk
from opentelemetry import trace as trace_api
from opentelemetry.sdk.trace.export import ConsoleSpanExporter, SimpleSpanProcessor
endpoint = "http://127.0.0.1:6006/v1/traces"
tracer_provider = trace_sdk.TracerProvider()
tracer_provider.add_span_processor(SimpleSpanProcessor(OTLPSpanExporter(endpoint)))
# Optionally, you can also print the spans to the console.
tracer_provider.add_span_processor(SimpleSpanProcessor(ConsoleSpanExporter()))
trace_api.set_tracer_provider(tracer_provider=tracer_provider)
# Start instrumenting agno
AgnoInstrumentor().instrument()
agent = Agent(
model=OpenAIChat(id="gpt-4o-mini"),
tools=[DuckDuckGoTools()],
markdown=True,
debug_mode=True,
)
agent.print_response("What is currently trending on Twitter?")
Finally, run the example:
python example.py
Finally, browse for your trace in Phoenix at http://localhost:6006!
More Info
1 maintainer
Metadata
1 maintainer
Release files for openinference-instrumentation-agno 1.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| openinference_instrumentation_agno-1.1.0.tar.gz | 26.2 kB | With provenance | Details for openinference_instrumentation_agno-1.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| openinference_instrumentation_agno-1.1.0-py3-none-any.whl | Python 3 | none | any | Details for openinference_instrumentation_agno-1.1.0-py3-none-any.whl |
Total release size: 57.5 kB
Release files / openinference_instrumentation_agno-1.1.0.tar.gz
| Download URL | openinference_instrumentation_agno-1.1.0.tar.gz |
|---|---|
| Size | 26.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
21ffb499e2930355ab219767ec3807cf7f2f90576d34f228abed647c17bee226
|
|
BLAKE2b-256 checksum How to use checksums |
59e7f5837389f2adc13ff62d9929d71ab21a0ff8a95ce8e40bcaf6205ce35aeb
|
| Upload date | |
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.
Transparency logRelease files / openinference_instrumentation_agno-1.1.0-py3-none-any.whl
| Download URL | openinference_instrumentation_agno-1.1.0-py3-none-any.whl |
|---|---|
| Size | 31.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f6e2e27810ade38b99d017b7491a53b615ee3c40d9dd82ebb7ba23cc0d39b26d
|
|
BLAKE2b-256 checksum How to use checksums |
c6478b54b7167dd2029293150cb58a5962f484b3e93f4ee5a4476defbfc2eccb
|
| Upload date | |
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.
Transparency logSecurity for openinference-instrumentation-agno 1.1.0
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.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for openinference_instrumentation_agno-1.1.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
