Python SDK

pip install tracelm

from tracelm import TraceLM

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

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

with tracelm.task(name="booking_flow", user_id="user_123") as task:
    tracelm.chat.completions.create(
        model="gpt-4o-mini",
        messages=[{"role": "user", "content": "Book a flight"}],
    )

    result = task.complete()  # run_detection=True by default

    if result:
        print(result.loops.detected)
        print(result.failures.explicit)
        print(result.context.total)
        print(result.tool_failure_count)
        print(result.context_failure_count)

detection = task.detect()
print(detection.loops.patterns)
print(detection.failures.semantic)
print(detection.context.lost_context)

with tracelm.conversation(user_id="user_123", session_id="sess_1") as conv:
    with conv.task(name="turn_1") as task:
        tracelm.chat.completions.create(model="gpt-4o-mini", messages=[{"role": "user", "content": "Hi"}])
        task.complete()

tasks = tracelm.list_tasks(has_issues=True)
item = tracelm.get_task("task-uuid")
convs = tracelm.list_conversations(user_id="user_123")
failures = tracelm.get_conversation_context_failures("conv-uuid")

TRACELM_API_KEY=lt_...
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GOOGLE_API_KEY=...
TRACELM_BASE_URL=https://api.tracelm.ai