TraceRoot 는 AI 에이전트를 위한 오픈소스 관측성 플랫폼입니다 — OpenTelemetry 호환 SDK 를 통해 트래스를 포착하고, 소스 코드와 Github 히스토리를 볼 수 있는 AI 로 디버깅합니다.
| 기능 | 설명 |
|---|
| Tracing | OpenTelemetry 호환 SDK 를 통해 LLM 호출, 에이전트 행동, 도구 사용량을 포착합니다. 중요한 트래스를 지능적으로 표면화 — 잡음을 필터링하고 신호를 우선시합니다. |
| Agentic Debugging | 모든 트래스를 볼 수 있는 AI 가 생산용 소스 코드가 실행되는 샌드박스에 연결하여 정확한 실패 행위를 식별하고, GitHub 커밋, PR, 이슈와 결관화합니다. 모든 모델 제공자를 위한 BYOK 지원. |
-
단순히 트래스로는 확장되지 않습니다. AI 에이전트 시스템이 복잡해질수록 모든 트래스를 수동으로 정렬하는 것은 지속 불가능합니다. TraceRoot 는 선택적으로 트래스를 스크린하여 잡음을 필터링하고 실제로 해결해야 할 것만 표면화하므로, 문제 해결에 시간을 투자하고 문제를 찾기 위해 시간을 보내지 않습니다.
-
에이전트 에이전트 시스템 디버깅은 고통스럽습니다. 에이전트 환각, 도구 호출 불안정성, 버전 변경에 걸친 근본 원인 분석은 어렵습니다. TraceRoot 의 AI 는 생산용 소스 코드가 실행되는 샌드박스에 연결하여 정확한 실패 행위를 식별하고 GitHub 히스토리를 교차 참조 — 커밋, PR, 오픈 이슈를 생성합니다.
-
완전히 오픈소스, 벤더 락인 없음. 관측성 플랫폼과 AI 디버깅 레이어 모두 오픈소스입니다. 모든 모델 제공자를 위한 BYOK 지원 — OpenAI, Anthropic, Gemini, xAI, DeepSeek, OpenRouter, Kimi, GLM 등.
Full documentation available at traceroot.ai/docs.
The fastest way to get started. Ample storages and LLM tokens for testing, no credit card needed. Sign up here!
- Developer mode: Run TraceRoot locally to contribute.
Get a copy of the latest repo git clone https://github.com/traceroot-ai/traceroot.git cd traceroot # Hosted the infras in docker and app itself locally make dev
For more details, see CONTRIBUTING.md.
- Local docker mode: Run TraceRoot locally to test.
Get a copy of the latest repo git clone https://github.com/traceroot-ai/traceroot.git cd traceroot # Hosted everything in docker make prod
- Terraform (AWS): Run TraceRoot on k8s with Helm and Terraform. This is for production hosting. Still in experimental stage.
| Integration | Supports | Description |
|---|
| OpenAI | Python, JS/TS | Automated instrumentation of Chat Completions and Responses API. |
| ... | | |
| Integration | Supports | Description |
| --- | --- | --- |
| LangChain & LangGraph | Python, JS/TS | Automated instrumentation by passing callback handler to LangChain application. |
| ... | | |
| Don't see your framework or provider? Request an integration. | | |
| Language | Repository |
|---|
| Python | traceroot-py |
| TypeScript | traceroot-ts |
pip install traceroot openai
import traceroot
from traceroot import Integration, observe
from openai import OpenAI
...
npm install @traceroot-ai/traceroot openai
import OpenAI from 'openai';
import { TraceRoot, observe } from '@traceroot-ai/traceroot';
TraceRoot.initialize({ instrumentModules: { openAI: OpenAI } });
...
Your data security and privacy are our top priorities. Learn more in our Security and Privacy documentation.
Special Thanks for pi-mono project, which powers the foundation of our agentic debugging runtime!
Contributing 🤝: If you're interested in contributing, you can check out our guide here. All types of help are appreciated :)
지원 💬: 어떤 형태의 지원이 필요하든 저희는 일반적으로 디스코드 채널에서 가장 반응이 빠르지만, [email protected] 로 이메일 보내셔도 좋습니다.
또한!
본 프로젝트는 Apache 2.0 라이선스 하에 추가적으로 기업용 기능을 포함하고 있습니다.