Metadata-Version: 2.4
Name: agent-tracedown-server
Version: 0.4.3
Summary: Tracedown server and CLI: root-cause analysis for AI agent runs, importers for Langfuse and OpenTelemetry, replay planning and a web viewer.
Author: Naveen Nair
License: Apache-2.0
Project-URL: Homepage, https://github.com/nbn07/agent-tracedown
Project-URL: Source, https://github.com/nbn07/agent-tracedown
Project-URL: Issues, https://github.com/nbn07/agent-tracedown/issues
Keywords: ai-agents,llm,observability,debugging,root-cause-analysis,opentelemetry,tracing,langfuse
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Debuggers
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: System :: Monitoring
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: agent-tracedown<0.5,>=0.4.0
Requires-Dist: fastapi>=0.110
Requires-Dist: uvicorn>=0.29
Requires-Dist: pydantic>=2
Provides-Extra: dev
Requires-Dist: pytest>=7; extra == "dev"
Requires-Dist: httpx>=0.27; extra == "dev"
Requires-Dist: chdb>=2; extra == "dev"
Requires-Dist: pyjwt[crypto]>=2.8; extra == "dev"
Requires-Dist: psycopg[binary]>=3.1; extra == "dev"
Requires-Dist: psycopg-pool>=3.2; extra == "dev"
Requires-Dist: redis>=5; extra == "dev"
Provides-Extra: sso
Requires-Dist: pyjwt[crypto]>=2.8; extra == "sso"
Provides-Extra: postgres
Requires-Dist: psycopg[binary]>=3.1; extra == "postgres"
Requires-Dist: psycopg-pool>=3.2; extra == "postgres"
Provides-Extra: redis
Requires-Dist: redis>=5; extra == "redis"
Provides-Extra: clickhouse
Provides-Extra: kafka
Requires-Dist: confluent-kafka>=2.3; extra == "kafka"
Provides-Extra: enterprise
Requires-Dist: pyjwt[crypto]>=2.8; extra == "enterprise"
Requires-Dist: confluent-kafka>=2.3; extra == "enterprise"
Requires-Dist: psycopg[binary]>=3.1; extra == "enterprise"
Requires-Dist: psycopg-pool>=3.2; extra == "enterprise"
Requires-Dist: redis>=5; extra == "enterprise"
Dynamic: license-file

# agent-tracedown-server

The analysis side of [Tracedown](https://github.com/nbn07/agent-tracedown), the flight recorder for AI agents:

- **Root-cause analysis.** AI stack traces that name the step that caused a failure, with an optional LLM judge.
- **A "who is at fault" verdict** for every failed run: the agent, the user, or nobody yet.
- **`tracedown-import`.** Diagnose runs you already record in Langfuse, Arize Phoenix or any OpenTelemetry exporter, with no code changes.
- **`tracedown up`.** The server and the full web app in one command, with demo runs to explore. No Node or Docker needed.
- **`tracedown-server`.** Ingest API, web app, incidents, drift reports, analytics and replay diffs, for production (Postgres, Redis, several workers).

```bash
pip install agent-tracedown-server
tracedown up                                      # http://127.0.0.1:7070, opens your browser
tracedown-import langfuse --errors-since 24h      # uses LANGFUSE_PUBLIC_KEY / LANGFUSE_SECRET_KEY
tracedown-import otlp traces.json --failed
tracedown-server --db tracedown.db                # http://localhost:7070
```

Benchmarks, including the cases where Tracedown loses to simple baselines, are in the [repository](https://github.com/nbn07/agent-tracedown#how-well-does-it-work). Licensed under Apache-2.0.
