Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tracectrl.ai/llms.txt

Use this file to discover all available pages before exploring further.

Core SDK

The core package is required for all instrumentors.
pip install tracectrl
Current version: 0.2.0 on PyPI.

Framework Instrumentors

Install the instrumentor that matches your agent framework. You only need one.
pip install tracectrl-instrumentation-strands
tracectrl-instrumentation-strands and tracectrl-instrumentation-agno are published on PyPI. LangChain, CrewAI, and Google ADK instrumentors are install-from-source for now — paste the git+ URL above.

Companion Tools

The CLI scanner ships separately and is pulled in as a dependency of the core SDK.
pip install tracectrl-scanner

Dependencies

Each instrumentor depends on:
  • tracectrl >= 0.1.0 (core SDK)
  • The corresponding openinference-instrumentation-* package (installed automatically)
The core SDK depends on:
  • opentelemetry-sdk
  • opentelemetry-exporter-otlp-proto-grpc
  • tracectrl-scanner

Requirements

  • Python 3.10 or later
  • An OpenTelemetry Collector endpoint (included in the Docker Compose stack)

Namespace Packages

TraceCtrl uses PEP 420 namespace packages — all instrumentors share the tracectrl.* namespace. You can install multiple instrumentors side-by-side:
pip install tracectrl
pip install tracectrl-instrumentation-strands
pip install tracectrl-instrumentation-agno
# Both work together without conflicts