spoor-sdk

Send agent and LLM traces to Spoor.

import spoor

spoor.init()  # reads SPOOR_API_KEY, SPOOR_URL (default http://localhost:8000)

init() turns on OpenLLMetry instrumentation for every installed library it supports (openai, anthropic, LangChain/LangGraph, litellm, OpenAI Agents SDK, CrewAI, LlamaIndex, google-genai, Bedrock, Mistral, Cohere, Groq, Ollama; see src/spoor/libraries.py) and exports spans over OTLP/HTTP. If the app already has an OTel TracerProvider, Spoor's exporter is added to it.

Options: api_key, url, service_name (else OTEL_SERVICE_NAME, else the script name), environment (else SPOOR_ENVIRONMENT, else main).

Operations

Each run belongs to an operation. It's named after the function that made the call, or explicitly:

@spoor.operation("triage")          # or bare @spoor.operation, or `with spoor.operation("triage"):`
def triage(ticket): ...

Test

uv run pytest