mohitkumar188/AgentTrace

Python

0

7 commits

updated Sep 8, 2026

See the code

See what people are saying (1)

README

⚡ AgentTrace: Production-Grade Agent Observability & Self-Healing Engine

Live Dashboard Backend API License: MIT

Live Production Demo:

An end-to-end observability SDK and dashboard for autonomous AI agent pipelines. It monitors multi-step tool calls, visualizes latency bottlenecks, and automatically repairs malformed LLM tool arguments at runtime without crashing workflows.


🎯 The Problem

LLMs frequently hallucinate tool arguments during multi-step runs:

  • Passing strings instead of floats (e.g. "1200 INR" instead of 1200.0)
  • Inventing key names (e.g. "user_identifier" instead of "user_id")
  • Omitting required schema fields

Normally, these cause immediate runtime crashes. AgentTrace catches these failures and auto-repairs them at runtime.


💡 Architecture & Tech Stack

  • Decorator SDK: Python, Pydantic (Validates schema before tool run)
  • Self-Healing Layer: Fast inference via Groq to repair payloads on failure
  • Collector Backend: FastAPI with SQLite persistence (traces.db)
  • Live Dashboard: Next.js, Tailwind CSS with Payload Diff Inspector

🚀 How to Run Locally

1. Start Backend

# In project root
python -m uvicorn main:app --reload --port 8000

Contributors

mohitkumar188

7 commits

mohitkumar188/AgentTrace

Python

0

7 commits

updated Sep 8, 2026

See the code

See what people are saying (1)

README

⚡ AgentTrace: Production-Grade Agent Observability & Self-Healing Engine

Live Dashboard Backend API License: MIT

Live Production Demo:

An end-to-end observability SDK and dashboard for autonomous AI agent pipelines. It monitors multi-step tool calls, visualizes latency bottlenecks, and automatically repairs malformed LLM tool arguments at runtime without crashing workflows.


🎯 The Problem

LLMs frequently hallucinate tool arguments during multi-step runs:

  • Passing strings instead of floats (e.g. "1200 INR" instead of 1200.0)
  • Inventing key names (e.g. "user_identifier" instead of "user_id")
  • Omitting required schema fields

Normally, these cause immediate runtime crashes. AgentTrace catches these failures and auto-repairs them at runtime.


💡 Architecture & Tech Stack

  • Decorator SDK: Python, Pydantic (Validates schema before tool run)
  • Self-Healing Layer: Fast inference via Groq to repair payloads on failure
  • Collector Backend: FastAPI with SQLite persistence (traces.db)
  • Live Dashboard: Next.js, Tailwind CSS with Payload Diff Inspector

🚀 How to Run Locally

1. Start Backend

# In project root
python -m uvicorn main:app --reload --port 8000

Contributors

mohitkumar188

7 commits

Languages

Python

51.2%

TypeScript

45.0%

JavaScript

2.0%

CSS

1.8%