agent-prism  by evilmartians

React components for visualizing AI agent traces

Created 10 months ago
357 stars

Top 78.3% on SourcePulse

GitHubView on GitHub
Project Summary

<2-3 sentences summarising what the project addresses and solves, the target audience, and the benefit.> AgentPrism offers React components for visualizing AI agent traces, transforming complex JSON data into clear, hierarchical diagrams. It targets developers debugging AI agents by providing a visual representation of plans, actions, and retries, turning raw trace data into actionable insights for improved understanding and debugging.

How It Works

The library provides a suite of React components that ingest trace data, primarily from OpenTelemetry or Langfuse formats, and render it as interactive visualizations. It employs a hierarchical timeline approach, allowing users to drill down into specific LLM calls, tool executions, and agent workflows. Adapters are provided to normalize various trace data sources into a consistent format optimized for UI rendering, facilitating debugging and understanding of agent behavior.

Quick Start & Requirements

  • Installation: Copy UI components via npx degit evilmartians/agent-prism/packages/ui/src/components src/components/agent-prism, then install data and types packages (npm install @evilmartians/agent-prism-data @evilmartians/agent-prism-types) along with required UI dependencies.
  • Prerequisites: React 19+, Tailwind CSS 3, TypeScript.
  • Links: Live demo: agent-prism.evilmartians.io. Storybook: storybook.agent-prism.evilmartians.io.

Highlighted Details

  • Visualizes AI agent traces, including plans, actions, and retries.
  • Supports data ingestion and adaptation from OpenTelemetry and Langfuse formats.
  • Features a hierarchical TreeView with search and expand/collapse functionality.
  • Includes a DetailsView for inspecting individual span attributes.

Maintenance & Community

The project is actively developed by Evil Martians. A Contribution Guide is available for potential contributors. No specific community channels (like Discord/Slack) or notable sponsorships are mentioned in the README.

Licensing & Compatibility

The license type is not explicitly stated. Compatibility for commercial use or closed-source linking requires clarification.

Limitations & Caveats

This library is an alpha release and is under active development, meaning APIs are subject to change.

Health Check
Last Commit

1 month ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
18 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.