Skip to main content

Prerequisites

  • A TraceLM account
  • A TraceLM project API key (lt_...)
  • At least one provider key: OPENAI_API_KEY, ANTHROPIC_API_KEY, or GOOGLE_API_KEY
  • Python 3.8+ or Node.js 18+

1. Install SDK

pip install tracelm

2. Initialize Client

from tracelm import TraceLM

tracelm = TraceLM(
    api_key="lt_your_tracelm_key",
    openai_api_key="sk-your-openai-key",
)

3. Send One Traced Call

response = tracelm.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Hello"}],
)

4. Generate Reliability Signals

Wrap calls in a task and complete it to trigger detection.
with tracelm.task(name="starter_task", user_id="user_123") as task:
    tracelm.chat.completions.create(
        model="gpt-4o-mini",
        messages=[{"role": "user", "content": "Use tools to plan a trip"}],
    )
    result = task.complete()

print(result.loops.detected)
print(result.tool_failure_count)
print(result.context_failure_count)

5. Open Reliability Summary

Open Dashboard -> First-Run Reliability Summary (/dashboard/first-run) and confirm the core cards:
  • Loop card
  • Context-loss card
  • Tool-failure card
  • Unnecessary-tool card

Next Steps

  • Explore SDK guides: /sdks/python, /sdks/typescript
  • Review endpoint contracts: /api-reference/overview
  • Learn the dashboard flow: /introduction/dashboard-guide