Pre-release

This release is a pre-release and may not be stable for production use.

pypi

This library provides OpenTelemetry instrumentation for smolagents. It wraps the model classes that run inference in your own process and emits a GenAI semantic-convention chat span and the matching metrics through opentelemetry-util-genai:

  • TransformersModel

  • VLLMModel

  • MLXModel

The API-backed model classes are not instrumented here. Each one calls a client library that carries its own instrumentation. Emitting a span at the smolagents layer as well would produce two chat spans for one model call, and would count the token-usage and duration metrics twice. Install the instrumentation for the client library instead:

smolagents model class

Instrument this instead

OpenAIModel, AzureOpenAIModel

opentelemetry-instrumentation-genai-openai

AmazonBedrockModel

opentelemetry-instrumentation-botocore

InferenceClientModel, LiteLLMModel, LiteLLMRouterModel

the instrumentation or built-in telemetry of the client library the model calls (huggingface_hub, litellm)

Agent runs (invoke_agent) and tool calls (execute_tool) are not instrumented yet. A model call made inside an agent run still gets a chat span, but no agent span sits above it.

TransformersModel is the only instrumented class with a generate_stream. A streamed call gets a chat span that stays open until the caller drains the deltas. This covers both stream_outputs=True on an agent and a direct generate_stream call. The span carries gen_ai.request.stream, and the call also records the gen_ai.client.operation.time_to_first_chunk and gen_ai.client.operation.time_per_output_chunk metrics.

Known gaps:

  • A subclass that inherits generate or generate_stream from one of the three classes above is instrumented. A subclass that overrides one is not: the override shadows the patched method, so the call produces no chat span.

  • A chat span reports no gen_ai.response.id, no gen_ai.response.model, no gen_ai.response.finish_reasons and no server.address. A runtime in this process returns the generated text and the token counts, nothing more. It also listens on no socket.

Installation

pip install opentelemetry-instrumentation-genai-smolagents

Usage

from opentelemetry.instrumentation.genai.smolagents import (
    SmolagentsInstrumentor,
)
from smolagents import TransformersModel

SmolagentsInstrumentor().instrument()

model = TransformersModel(model_id="HuggingFaceTB/SmolLM2-135M-Instruct")
model.generate(
    [
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "How many seconds are in a week?"}
            ],
        }
    ]
)

Configuration

Capture Message Content

By default, prompts and completions are not captured. To capture message content, set the environment variable OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT to one of NO_CONTENT, SPAN_ONLY, EVENT_ONLY, or SPAN_AND_EVENT:

export OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=SPAN_AND_EVENT

Uploading Content to External Storage

Captured prompt and completion content can be forwarded to external storage through a completion hook instead of being recorded inline. Select the built-in upload hook and point it at a destination:

export OTEL_INSTRUMENTATION_GENAI_COMPLETION_HOOK=upload
export OTEL_INSTRUMENTATION_GENAI_UPLOAD_BASE_PATH=/path/to/prompts  # or gs://my_bucket

The upload hook is provided by opentelemetry-util-genai and requires its [upload] extra. See the opentelemetry-util-genai README for the other content-capture and upload options it owns.

You can also pass a hook programmatically, which takes precedence over the environment variable:

from opentelemetry.instrumentation.genai.smolagents import (
    SmolagentsInstrumentor,
)

SmolagentsInstrumentor().instrument(completion_hook=my_hook)

Conformance

The scenarios that check this package against the GenAI semantic conventions live under tests/conformance/.

References

Project links

Data verified by PyPI on Aug 20, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

Owner

PyPI data
Data sourced directly from PyPI's database.

Credits

Author: OpenTelemetry Authors

GitHub Statistics

Data verified by PyPI on Aug 20, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

Apache-2.0
View SPDX License List

Requires

Python >=3.10

Provides Extra

instruments

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

opentelemetry_instrumentation_genai_smolagents-1.1b0.tar.gz (30.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

opentelemetry_instrumentation_genai_smolagents-1.1b0-py3-none-any.whl (20.1 kB view details)

Uploaded Python 3

File details

Details for the file opentelemetry_instrumentation_genai_smolagents-1.1b0.tar.gz.

File metadata

File hashes

Hashes for opentelemetry_instrumentation_genai_smolagents-1.1b0.tar.gz
Algorithm Hash digest
SHA256 e18d0b9a848f2cc0694741c56589515fad819b672d112425fb5951179723454c
MD5 410aeb34f5ad078bacc541e94849e0dc
BLAKE2b-256 fd6da7115cb0327e479d0081d60a96913582adacce2acdd8f7d73e0f5051c09b

See more details on using hashes here.

Provenance

The following attestation bundles were made for opentelemetry_instrumentation_genai_smolagents-1.1b0.tar.gz:

Publisher: release-all.yml on open-telemetry/opentelemetry-python-genai

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file opentelemetry_instrumentation_genai_smolagents-1.1b0-py3-none-any.whl.

File metadata

File hashes

Hashes for opentelemetry_instrumentation_genai_smolagents-1.1b0-py3-none-any.whl
Algorithm Hash digest
SHA256 79124fd8ef40c0cdd33d91af423e8697d297f9a7c09e1f3dd20466afa7e9908e
MD5 00fd4f82ccdc8d65b66281414c5c11c2
BLAKE2b-256 e78536f732a65ee171d35cc6de8021e7d40c5eb61dcfe3f248afdcddc3cdf1ca

See more details on using hashes here.

Provenance

The following attestation bundles were made for opentelemetry_instrumentation_genai_smolagents-1.1b0-py3-none-any.whl:

Publisher: release-all.yml on open-telemetry/opentelemetry-python-genai

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page