chronicle-agent-sdk 0.8.0

Python SDK for capturing and shipping AI agent traces to a Chronicle server

chronicle-sdk

Python SDK for Chronicle — the Chrome DevTools for AI agents.

Instrument your agent code with ChronicleTracer to capture tool calls, LLM calls, agent messages, memory updates, errors, and retries. Events are buffered and flushed to a local Chronicle server over HTTP in batches; if the server isn't running, unsent events are written to chronicle_runs/{run_id}.json so nothing is lost.

Install

pip install -e .

Usage

from chronicle import ChronicleTracer

with ChronicleTracer() as tracer:
    tracer.record_event("tool_call", data={"tool_name": "search", "arguments": {"query": "weather in nyc"}})
    tracer.record_event("llm_call", data={"model": "gpt-4o", "prompt": "What's the weather?"})
    tracer.record_event("agent_message", data={"role": "assistant", "content": "It's sunny."})

LangGraph / LangChain

from chronicle import ChronicleTracer, LangGraphAdapter

tracer = ChronicleTracer()
adapter = LangGraphAdapter(tracer)

graph.invoke(input, config={"callbacks": [adapter]})

Development

pip install -e ".[dev]"
pytest