Installation

Python SDK

pip install retrace

Requires Python 3.10 or later. The SDK has minimal dependencies:

• @google/genai - For Gemini interceptor
• websockets / websocket-client - For real-time streaming
• requests - For HTTP fallback transport

TypeScript SDK

npm install retrace

Requires Node.js 20 or later. ESM-only package.

Environment Variables

[!NOTE] Get your API key from the Settings page in the dashboard.

Verify Installation

import retrace

retrace.configure(api_key="rt_live_...")

@retrace.record(name="test")
def hello():
    return "world"

hello()  # Check your dashboard
print("Retrace is working!")

Programmatic Configuration

You can also configure the SDK programmatically instead of using environment variables:

import retrace

retrace.configure(
    api_key="rt_live_...",
    base_url="http://localhost:3001",  # For local development
    project_id="my-project-id",
)