AutoTrace Python SDK (autotrace-py)

Lightweight, zero-dependency Python client for autonomous error tracking and AI triage with AutoTrace.

Installation

pip install autotrace
# or from source:
pip install -e ./sdk/python

Quickstart

import autotrace

# 1. Initialize once at application startup
autotrace.init(
    api_key="<YOUR_API_KEY>",
    endpoint_url="http://localhost:8000/api/ingest/",
    environment="production",
    context={"service": "payment-api", "version": "2.1.0"},
)

# 2. Manual Exception Capture
try:
    process_order()
except Exception as exc:
    autotrace.capture_exception(
        exc_info=exc,
        endpoint="/api/v1/orders",
        context={"user_id": "usr_123"},
    )

Function Decorator

@autotrace.trace(endpoint="/jobs/sync-inventory")
def sync_inventory():
    # If this raises, AutoTrace captures the error and traceback
    perform_risky_task()

Framework Integrations

Django

In your settings.py:

AUTOTRACE_API_KEY = "<YOUR_API_KEY>"
AUTOTRACE_ENDPOINT = "http://localhost:8000/api/ingest/"

MIDDLEWARE = [
    # ... other middleware
    "autotrace.integrations.django.AutoTraceMiddleware",
]

FastAPI / Starlette

In your main.py:

from fastapi import FastAPI
import autotrace
from autotrace.integrations.fastapi import AutoTraceMiddleware

autotrace.init(api_key="<YOUR_API_KEY>")

app = FastAPI()
app.add_middleware(AutoTraceMiddleware)