Skip to content

README.md

Latest commit

 

History

History
124 lines (92 loc) · 3.42 KB

README.md

File metadata and controls

124 lines (92 loc) · 3.42 KB

Dissect

Visualize AI Agent Workflows | LangChain • CrewAI • AutoGen • OpenTelemetry

License Python Coverage Ruff AI Powered

Dissect helps you understand what's happening inside your AI agent systems. Parse traces, visualize workflows, and identify bottlenecks.

Dissect Visualization

Features

  • 🔌 Multi-Framework Support – Works with LangChain, CrewAI, AutoGen, and any OpenTelemetry-compatible system
  • 📊 Beautiful Visualizations – Interactive HTML, Mermaid diagrams, Graphviz DOT
  • ⏱️ Critical Path Analysis – Identify the slowest paths in your workflows
  • 🚀 Zero Config – Auto-detects trace formats

Quick Start

# Install
pip install dissect

# Parse a trace file
dissect trace --file trace.json

# Generate interactive HTML visualization
dissect visualize --file trace.json --format html --output workflow.html

# Generate Mermaid diagram
dissect visualize --file trace.json --format mermaid --output workflow.md

Example Output

✓ Parsed successfully!
  Name: Trace
  Nodes: 7
  Edges: 6

  Critical Path (750ms):
    → User Query (50ms)
    → Writer Agent (400ms)
    → Claude Call (300ms)

Supported Trace Formats

Format Auto-Detected By
OpenTelemetry spans or resourceSpans field
LangChain runs or run_type field
CrewAI crew_name, agents + tasks
AutoGen agents + messages

Visualization Formats

Format Command Use Case
HTML --format html Interactive exploration
Mermaid --format mermaid Documentation, GitHub
DOT --format dot Graphviz rendering
JSON --format json Programmatic access

Development

# Clone
git clone https://github.com/Lemniscate-world/Dissect.git
cd Dissect

# Install in dev mode
pip install -e .

# Run tests
python -m pytest

Roadmap

  • Multi-framework trace parsing
  • HTML/Mermaid/DOT export
  • Critical path analysis
  • 🌡️ Latency Heatmaps (Bottleneck detection)
  • dissect explain (AI-powered insights)
  • dissect watch (Live trace streaming)
  • VS Code extension
  • Dissect Cloud (hosted dashboard)

Architecture

Class Diagram

Class Diagram

Sequence Diagram

sequenceDiagram
    participant User
    participant CLI
    participant Parser
    participant Graph
    participant Exporter

    User->>CLI: dissect trace file.json
    CLI->>Parser: parse_trace_file(path)
    Parser->>Parser: Auto-detect format
    Parser->>Graph: Create Nodes & Edges
    Graph-->>CLI: OrchestrationGraph
    CLI->>Exporter: export(graph, format='html')
    Exporter-->>User: workflow.html
Loading

License

Apache 2.0 – see LICENSE

Built with ❤️ by Lemniscate World