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

# Quickstart

> Send your first trace in under 5 minutes

## 1. Install the SDK

```bash theme={null}
pip install agentx-python
```

## 2. Get your API key

Go to **Settings → API Keys** in the [AgentX dashboard](https://app.agentx.so/settings/account) and create a workspace key.

```bash theme={null}
export AGENTX_API_KEY=ax_live_xxxxxxxxxxxxxxxx
```

## 3. Wrap your agent

<CodeGroup>
  ```python Decorator theme={null}
  from agentx import AgentX

  client = AgentX.from_env()

  @client.tracer.trace("my-agent", framework="langchain")
  def run(query: str) -> str:
      return chain.invoke(query)   # your existing code

  run("How do I reset my password?")
  # trace is submitted automatically in the background
  ```

  ```python Context manager theme={null}
  from agentx import AgentX

  client = AgentX.from_env()

  with client.tracer.trace("my-agent", framework="langchain") as span:
      span.input = query
      result = chain.invoke(query)
      span.output = result
  ```
</CodeGroup>

## 4. See traces in the UI

Open the **Live Traces** tab in your workspace — the trace will appear within a few seconds.

***

## Next steps

<CardGroup cols={2}>
  <Card title="Full tracing guide" icon="magnifying-glass" href="/sdk/tracing">
    Tool calls, sessions, async agents
  </Card>

  <Card title="CI/CD gate" icon="shield-check" href="/sdk/ci-cd">
    Block bad releases with eval test sets
  </Card>
</CardGroup>