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

# Python SDK

> Instrument FastAPI, Django, Flask, and async Python applications.

## Installation

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

***

## FastAPI Integration

```python theme={null}
from fastapi import FastAPI
import traceback_sdk
from traceback_sdk.integrations.fastapi import TracebackFastAPIMiddleware

traceback_sdk.init(
    dsn="https://tb_live_key@ingest.traceback.dev/1",
    environment="production",
    traces_sample_rate=1.0,
    send_default_pii=False,
)

app = FastAPI()
app.add_middleware(TracebackFastAPIMiddleware)

@app.get("/items/{item_id}")
async def read_item(item_id: int):
    if item_id == 0:
        raise ValueError("Invalid item ID zero")
    return {"item_id": item_id}
```

***

## Django Integration

Add Traceback to your `settings.py`:

```python theme={null}
import traceback_sdk

traceback_sdk.init(
    dsn=os.environ.get("TRACEBACK_DSN"),
    integrations=["django"],
    traces_sample_rate=0.2,
)
```
