NHClimber87 GitHub avatar

llm-serve-dashboard

NHClimber87

A single-file, dependency-free live dashboard for local LLM serving boxes, displaying GPU utilization, per-model throughput, KV/context fill, and system stats for llama.cpp and vLLM.

Stars

64

7-day growth

No data

Forks

10

Open issues

0

License

MIT

Last updated

2026-07-16

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

No framework, no build step, no external requests; it's a zero-setup tool that works out of the box with just Python and nvidia-smi, plus an optional Rust build for accurate client-measured throughput and SSE push.

Who it is for

  • Developers running local LLM inference servers
  • System administrators monitoring GPU utilization
  • Researchers experimenting with multiple LLM backends
  • Hobbyists building local AI boxes

Use cases

  • Real-time monitoring of GPU and throughput for llama.cpp/vLLM servers
  • Detecting bottlenecks and optimizing model deployment
  • Tracking per-request reasoning/chain-of-thought logs via optional reasoning tap
  • Browsing model library and comparing performance metrics

Strengths

  • Single-file backend with zero dependencies (Python stdlib only)
  • Auto-discovery of worker port from listening sockets
  • Optional reasoning tap for live CoT panels
  • Two build options: Python for quick setup, Rust for accurate throughput and SSE push

Considerations

  • Requires NVIDIA GPUs for nvidia-smi
  • No authentication (intended for local use, but binds to 0.0.0.0)
  • Python build uses predicted_tokens_seconds gauge which may read 0 during idle periods

README quick start

LLM Serve Dashboard

A single-file, dependency-free live dashboard for your local LLM serving box — GPU utilization, per-model throughput, KV/context fill, and system stats for llama.cpp and vLLM, in one green terminal-styled page.

No framework, no build step, no external requests. The frontend is one index.html (opens on file://); the backend is one stdlib Python file that reads nvidia-smi and each server's Prometheus /metrics.

(Screenshot rendered with example data — plug in your own box and it goes live.)

What it shows

  • GPUs — per-card utilization, VRAM, power, temperature, clocks, and the actual compute tenants on each card (pulled from nvidia-smi --query-compute-apps, so cards are labeled from ground truth, not VRAM guesswork).
  • Primary worker — decode & prefill tokens/sec, request counts, context/KV fill, LoRA adapters. Works with llama.cpp (/metrics + /props) and vLLM (/metrics + /v1/models). The worker port is auto-discovered from listening sockets, so a bench or swap that moves the model to another port still lands on the dashboard.
  • Secondary servers — an optional row of cards for extra CPU/GPU llama-servers you run (point them at any endpoints — a small CPU model, a second box, etc.). Configure with SECONDARY_SERVERS.
  • System — CPU, RAM, load, network, disk.
  • Model library — a browsable inventory of your loadable models with quant, ctx, and measured throughput, driven by a JSON registry you edit.
  • Reasoning tap (optional) — live per-request reasoning/CoT panels, if you tee a model's reasoning_content to a log (see THOUGHT_LOG below). Off by default.

Run it

Requirements: Python 3.8+ and nvidia-smi (NVIDIA GPUs). No pip installs.

# 1. start the metrics endpoint (serves JSON on :8092)
python3 fleet-metrics.py

# 2. open the dashboard
xdg-open index.html      # or just double-click it / open in a browser

The page polls http://localhost:8092 for live data. That's it.

Point it at your servers

By default it looks for a llama.cpp/vLLM server on :8001 (then :8010, :8123). Override:

# candidate ports for the primary worker (first responder with the largest ctx wins)
WORKER_PORT_CANDIDATES=8000,8001,8080 python3 fleet-metrics.py

# secondary servers shown as extra cards: name:port,name:port
SECONDARY_SERVERS='cpu-a:9093,b

Description

Single-file, dependency-free live dashboard for local llama.cpp/vLLM serving — GPU, throughput, KV/ctx, model library. Stdlib Python + one local-first HTML page.

Related repositories

Similar projects matched by category, topics, and programming language.

ddosi
Featured
ddosi GitHub avatar

PacketLens

PacketLens is a pure front-end, offline pcap analysis tool that runs entirely in the browser, supporting deep protocol decoding, HTTPS decryption, and million-packet instant loading without any backend.

HTML
17
ViffyGwaanl
Featured
ViffyGwaanl GitHub avatar

kimi-k3-learn

An interactive learning system that turns the 47-page Kimi K3 technical report into a single offline HTML file with running algorithms, 3D visualizations, spaced repetition quizzes, and a smart highlighting QA tool.

AI & Machine Learning
15
iamtechartist
Featured
iamtechartist GitHub avatar

human-cell-visualizer

An interactive 3D visualization of three human cell types using Three.js, WebGL particles, and custom GLSL shaders, allowing users to rotate, zoom, morph, and explore annotated structures.

Design & Creative
13