> ## 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.

# Installation

> Install the TraceCtrl SDK and framework instrumentors

## Core SDK

The core package is required for all instrumentors.

```bash theme={"dark"}
pip install tracectrl
```

Current version: `0.2.0` on PyPI.

## Framework Instrumentors

Install the instrumentor that matches your agent framework. You only need one.

<CodeGroup>
  ```bash AWS Strands theme={"dark"}
  pip install tracectrl-instrumentation-strands
  ```

  ```bash Agno theme={"dark"}
  pip install tracectrl-instrumentation-agno
  ```

  ```bash LangChain / LangGraph theme={"dark"}
  pip install "tracectrl-instrumentation-langchain @ git+https://github.com/cloudsineai/tracectrl.git#subdirectory=sdk/tracectrl-instrumentation-langchain"
  ```

  ```bash CrewAI theme={"dark"}
  pip install "tracectrl-instrumentation-crewai @ git+https://github.com/cloudsineai/tracectrl.git#subdirectory=sdk/tracectrl-instrumentation-crewai"
  ```

  ```bash Google ADK theme={"dark"}
  pip install "tracectrl-instrumentation-google-adk @ git+https://github.com/cloudsineai/tracectrl.git#subdirectory=sdk/tracectrl-instrumentation-google-adk"
  ```
</CodeGroup>

<Info>
  `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.
</Info>

## Companion Tools

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

```bash theme={"dark"}
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](https://peps.python.org/pep-0420/) — all instrumentors share the `tracectrl.*` namespace. You can install multiple instrumentors side-by-side:

```bash theme={"dark"}
pip install tracectrl
pip install tracectrl-instrumentation-strands
pip install tracectrl-instrumentation-agno
# Both work together without conflicts
```