> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trajectory.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Turn your traces and telemetry into Trajectories - the core primitive for Continual Learning.

# Trajectory SDK

Trajectory SDK turns raw agent traces and product telemetry into our standardized **Trajectory**
format — the primitive for training, evaluation, and continual learning. Ingest from
observability platforms like [LangSmith](https://smith.langchain.com/), build trajectories from
your own data, or push live telemetry events from your app.

## Install

```bash theme={null}
pip install trajectory-sdk
```

## Key Features

* **Ingest traces from anywhere** — LangSmith today, extensible to any trace source
* **Bring your own data** — build trajectories from CSV/JSONL/OpenAI/Anthropic/Vercel messages with shipped recipes
* **Push product telemetry events** — first-class `TelemetryEvent` primitive with idempotent push
* **Correlate trajectories and events** — caller-owned `trace_id` links uploaded trajectories to the telemetry produced in the same trace
* **Standardized Trajectory schema** — typed dataclasses for messages, tool calls, rewards, and metrics
* **E2E bulk export** — discover all conversations, trigger a LangSmith bulk export, download, parse, and upload in three lines
* **PII redaction** — pluggable transform-based redaction before data leaves your environment
* **Three-line setup** — go from raw traces (or your own data) to the Trajectory platform in minutes

All processing runs locally. Your API key and data never leave your environment.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="bolt" href="/quickstart">
    Export your first trajectories in under 5 minutes.
  </Card>

  <Card title="Bring Your Own Data" icon="file-import" href="/sdk/bring-your-own-data">
    Build trajectories from CSV / JSONL / OpenAI / Anthropic.
  </Card>

  <Card title="Telemetry Events" icon="signal-stream" href="/sdk/telemetry-events">
    Push product telemetry from your app into Trajectory.
  </Card>

  <Card title="Linking Events to Trajectories" icon="link" href="/sdk/linking-events-to-trajectories">
    Correlate uploaded trajectories with telemetry via `trace_id`.
  </Card>

  <Card title="Import Traces" icon="download" href="/sdk/import-traces">
    Standard LangSmith API import walkthrough.
  </Card>

  <Card title="API Reference" icon="square-terminal" href="/sdk/api-reference">
    Full function signatures and parameters.
  </Card>
</CardGroup>