Skip to main content

​
Core SDK

The core package is required for all instrumentors. 
pip install -e ./sdk/tracectrl

​
Framework Instrumentors

Install the instrumentor that matches your agent framework. You only need one. 
pip install -e ./sdk/tracectrl-instrumentation-langchain

​
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

​
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 -e ./sdk/tracectrl
pip install -e ./sdk/tracectrl-instrumentation-langchain
pip install -e ./sdk/tracectrl-instrumentation-crewai
# Both work together without conflicts
The SDK is currently distributed as editable installs from the monorepo. PyPI packages are planned for a future release.