OpenInference DSPy Instrumentation

Python auto-instrumentation library for DSPy.

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-dspy

Quickstart

This quickstart shows you how to instrument your DSPy application. It is adapted from the DSPy quickstart.

Install required packages.

pip install openinference-instrumentation-dspy dspy-ai 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.)

python -m phoenix.server.main serve

Set up DSPyInstrumentor to trace your DSPy application and sends the traces to Phoenix at the endpoint defined below.

from openinference.instrumentation.dspy import DSPyInstrumentor
from opentelemetry import trace as trace_api
from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter
from opentelemetry.sdk import trace as trace_sdk
from opentelemetry.sdk.trace.export import SimpleSpanProcessor

endpoint = "http://127.0.0.1:6006/v1/traces"
tracer_provider = trace_sdk.TracerProvider()
trace_api.set_tracer_provider(tracer_provider)
tracer_provider.add_span_processor(SimpleSpanProcessor(OTLPSpanExporter(endpoint)))

DSPyInstrumentor().instrument()

Import dspy and configure your language model.

import dspy
from dspy.datasets.gsm8k import GSM8K, gsm8k_metric

turbo = dspy.OpenAI(model='gpt-3.5-turbo-instruct', max_tokens=250)
dspy.settings.configure(lm=turbo)
gms8k = GSM8K()
gsm8k_trainset, gsm8k_devset = gms8k.train[:10], gms8k.dev[:10]

Define a custom program that utilizes the ChainOfThought module to perform step-by-step reasoning to generate answers.

class CoT(dspy.Module):
    def __init__(self):
        super().__init__()
        self.prog = dspy.ChainOfThought("question -> answer")
    
    def forward(self, question):
        return self.prog(question=question)

Optimize your program using the BootstrapFewShotWithRandomSearch teleprompter.

from dspy.teleprompt import BootstrapFewShot

config = dict(max_bootstrapped_demos=4, max_labeled_demos=4)
teleprompter = BootstrapFewShot(metric=gsm8k_metric, **config)
optimized_cot = teleprompter.compile(CoT(), trainset=gsm8k_trainset, valset=gsm8k_devset)

Evaluate performance on the dev dataset.

from dspy.evaluate import Evaluate

evaluate = Evaluate(devset=gsm8k_devset, metric=gsm8k_metric, num_threads=4, display_progress=True, display_table=0)
evaluate(optimized_cot)

Visit the Phoenix app at http://localhost:6006 to see your traces.

More Info

Metadata

Release files for openinference-instrumentation-dspy 0.1.45

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-dspy 0.1.45
File	Size	Uploaded
openinference_instrumentation_dspy-0.1.45.tar.gz	27.3 kB	Sep 10, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for openinference-instrumentation-dspy 0.1.45
File	Interpreter	ABI	Platform	Reset
openinference_instrumentation_dspy-0.1.45-py3-none-any.whl 15.7 kB Sep 10, 2026	Python 3	none	any	Details

Total release size: 43.0 kB

Release files / openinference_instrumentation_dspy-0.1.45.tar.gz

Download URL	openinference_instrumentation_dspy-0.1.45.tar.gz
Size	27.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`6bfe6ed981f9cf3017a80204fb1da2f7cb11fd2e3ec64ed5219fc106c0300053`
BLAKE2b-256 checksum How to use checksums	`35810961bb9c42619d1cd1e0b1bcfd5acaed175b27f0868598c5f0473bb596fc`
Upload date	Sep 10, 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/3729ab43046050c2b99fc96af32151813791e939

Workflow

Publishing configuration: github.com/Arize-ai/openinference/blob/3729ab43046050c2b99fc96af32151813791e939/.github/workflows/publish.yaml
Publishing logs: github.com/Arize-ai/openinference/actions/runs/34442159013/attempts/1

Artifact

Subject: openinference_instrumentation_dspy-0.1.45.tar.gz
SHA-256 checksum: 6bfe6ed981f9cf3017a80204fb1da2f7cb11fd2e3ec64ed5219fc106c0300053 Verifying attestations

Release files / openinference_instrumentation_dspy-0.1.45-py3-none-any.whl

Download URL	openinference_instrumentation_dspy-0.1.45-py3-none-any.whl
Size	15.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`ffcaaf8368b6338da123f867dec336d13ff7bb40defda22dbee6f171ba6002f6`
BLAKE2b-256 checksum How to use checksums	`3fa9c9f102f7720bb926494a29a99a56af1466016461b5f146b9522fcdf76074`
Upload date	Sep 10, 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/3729ab43046050c2b99fc96af32151813791e939

Workflow

Publishing configuration: github.com/Arize-ai/openinference/blob/3729ab43046050c2b99fc96af32151813791e939/.github/workflows/publish.yaml
Publishing logs: github.com/Arize-ai/openinference/actions/runs/34442159013/attempts/1

Artifact

Subject: openinference_instrumentation_dspy-0.1.45-py3-none-any.whl
SHA-256 checksum: ffcaaf8368b6338da123f867dec336d13ff7bb40defda22dbee6f171ba6002f6 Verifying attestations