🔍 TraceRoot helps engineers debug production issues 10× faster using AI-powered analysis of traces, logs, and code context.

• Visit the TraceRoot website to start debugging your production issues.
• Explore the TraceRoot documentation to get started with the TraceRoot library.
• Join our Discord community for discussions.

About

TraceRoot accelerates the debugging process with AI-powered insights. It integrates seamlessly into your development workflow, providing real-time trace and log analysis, code context understanding, and intelligent assistance.

Demo

Features

Feature	Description
🚀 Ease of Use	Get started with TraceRoot in minutes with our simple setup process
🤖 LLM Flexibility	Bring your own model (OpenAI, Anthropic, local LLMs) for AI-powered debugging
🌐 Distributed Services	Cross-platform support with distributed setup for enterprise-scale debugging
💻 AI Debugging Interface	Cursor-like interface specialized for debugging with AI assistance
🔌 Integration Support	Native integration with GitHub, Notion, and other development tools

Getting started with TraceRoot

TraceRoot Cloud (Recommended)

The fastest and most reliable way to start with TraceRoot is by signing up for free to TraceRoot Cloud for a 7-day trial. You’ll get:

• 150k traces + logs storage with 30-day retention
• 1.5M LLM tokens
• AI agent with chat mode

Self-hosting TraceRoot (Advanced)

If you want to self-host TraceRoot, you can deploy a starter instance in one line on Linux with Docker:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/traceroot-ai/traceroot/HEAD/bin/deploy-starter)"

Open source deployments should scale to a certain point, after which we recommend migrating to TraceRoot Cloud.

This will start the UI at http://localhost:3000 and the API at http://localhost:8000.

Setting up TraceRoot

Whether you're using TraceRoot Cloud or self-hosting, you'll need our SDK:

Available SDKs

Language	Repository
Python	traceroot-sdk
JavaScript/TypeScript	traceroot-sdk-ts

For more details on SDK usage and examples, please check out this Quickstart.

AI Agent Framework

Here is an overview for our AI Agent Framework:

Context Model

Chunking

TODO

Explainability

Please checkout the README.md in the rest/agent directory for more details.

Citation

If you find our exploratory TraceRoot useful in your research, please consider citing:

@article{traceroot_2025,
  title={TraceRoot Is All You Need for Debugging and Tracing},
  author={Zecheng Zhang and Xinwei He},
  year = {2025},
  publisher = {GitHub},
  url = {https://github.com/traceroot-ai/traceroot}
}