Skip to main content

​
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