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.47

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.47
File	Size	Uploaded
openinference_instrumentation_dspy-0.1.47.tar.gz	28.8 kB	Oct 1, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for openinference-instrumentation-dspy 0.1.47
File	Interpreter	ABI	Platform	Reset
openinference_instrumentation_dspy-0.1.47-py3-none-any.whl 16.2 kB Oct 1, 2026	Python 3	none	any	Details

Total release size: 45.1 kB

Release files / openinference_instrumentation_dspy-0.1.47.tar.gz

Download URL	openinference_instrumentation_dspy-0.1.47.tar.gz
Size	28.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`f9449f287837eee837099eca657a1fc96714e183f0db0b865263128f0bb17d72`
BLAKE2b-256 checksum How to use checksums	`4ef0c042abc173711e722333ee0eeb258b7ac1c9b48b43430ee1a786f98590d2`
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/c7f15ec66b1374ee3e7aafbdba5a55959afacac7

Workflow

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

Artifact

Subject: openinference_instrumentation_dspy-0.1.47.tar.gz
SHA-256 checksum: f9449f287837eee837099eca657a1fc96714e183f0db0b865263128f0bb17d72 Verifying attestations

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

Download URL	openinference_instrumentation_dspy-0.1.47-py3-none-any.whl
Size	16.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`ce9745376b98d6c008e1a3ef4594360284958d6c59c99039ac418ade47d122ad`
BLAKE2b-256 checksum How to use checksums	`d90c8f34bd95078e22fd047134874285c18720052d426497e1e9558adff4a2a9`
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/c7f15ec66b1374ee3e7aafbdba5a55959afacac7

Workflow

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

Artifact

Subject: openinference_instrumentation_dspy-0.1.47-py3-none-any.whl
SHA-256 checksum: ce9745376b98d6c008e1a3ef4594360284958d6c59c99039ac418ade47d122ad Verifying attestations