aashu3201/reveal repository overview

⁠PerfSage Reveal

Turn raw JMeter results into actionable performance intelligence — in one container.

⁠🎯 What it does

PerfSage Reveal ingests JTL / CSV / XML load-test output and delivers:

• 29 interactive charts — latency scatter, percentile bands, throughput, heatmaps, CDF, APDEX, SLO gauges
• Expert recommendations — tail-latency ratio, saturation knee, error spikes, SLO violations
• AI narrative — optional GPT / Claude / Gemini insights on any report
• Export — self-contained HTML or print-quality PDF with embedded chart images

⁠⚡ Quick start

docker run -d \
  --name perfsage-reveal \
  -p 8000:8000 \
  -v perfsage-reveal-data:/app/data \
  -e PERFSAGE_SECRET="your-32-char-random-secret-here" \
  aashu3201/reveal:latest

Open http://localhost:8000⁠ → upload a .jtl / .csv / .xml file → explore charts → export HTML or PDF.

⁠🐳 Tags

⁠🔧 Configuration

⁠📦 What's inside

One image runs everything via supervisord:

Browser (HTMX + Plotly)
    ↔ FastAPI (uvicorn)
    → Redis (job queue + SSE progress)
    → arq worker (ingest + analysis)
    → SQLite + Parquet (persistent storage)
    → LLM providers (optional AI insights)

Supported JMeter: 2.x through 5.6 — CSV and XML JTL formats.

⁠📚 Documentation

• Full README: github.com/perfsage/reveal⁠
• Issues & releases: GitHub Releases⁠
• License: MIT

⁠🛠 Docker Compose (recommended)

git clone https://github.com/perfsage/reveal.git
cd reveal
cp .env.example .env   # set PERFSAGE_SECRET
docker compose up -d

Built with ❤️ by PerfSage⁠ — generating value in performance analysis.