sparkstation-diagnose

One-command health check for Sparkstation. Shows GPU status, model states, container health, recent log errors, memory usage, and thermal status. Use when asked to "diagnose", "check health", "what's wrong", "system status", or "why is X slow/broken".

Jump to install

Repository: kshetrajna12/sparkstation
Last source activity: March 15, 2026 at 21:26
Detected SKILL.md language: English
Stars: 6
Forks: 1

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/kshetrajna12/sparkstation --skill sparkstation-diagnose

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

2 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

Sparkstation Diagnose

Comprehensive system health check in a single command.

Usage

# Full diagnostic report python3 .pi/skills/sparkstation-diagnose/scripts/diagnose.py # Quick status only (no log analysis) python3 .pi/skills/sparkstation-diagnose/scripts/diagnose.py --quick # JSON output for programmatic use python3 .pi/skills/sparkstation-diagnose/scripts/diagnose.py --json # Check specific component python3 .pi/skills/sparkstation-diagnose/scripts/diagnose.py --component gpu python3 .pi/skills/sparkstation-diagnose/scripts/diagnose.py --component models python3 .pi/skills/sparkstation-diagnose/scripts/diagnose.py --component containers python3 .pi/skills/sparkstation-diagnose/scripts/diagnose.py --component logs python3 .pi/skills/sparkstation-diagnose/scripts/diagnose.py --component gateway

What It Checks

GPU: Memory usage, temperature, power draw, utilization, thermal warnings

Supervisor: Health endpoint, running/failed/suspended model counts

Models: Per-model status, health, idle time, memory allocation vs actual

Containers: Docker container status, restarts, resource usage

Gateway: LiteLLM health, registered models, routing status

Logs: Recent errors/warnings from sparkstation.log (last 100 lines)

Resources: Memory allocation vs limits, port usage, disk space for models

Output

Color-coded terminal output with ✅/⚠️/❌ indicators:

═══ SPARKSTATION DIAGNOSTICS ═══ GPU STATUS ✅ OK Memory: 45.2 / 128.0 GiB (35.3%) Temperature: 52°C (threshold: 80°C) Power: 180W / 400W SUPERVISOR ✅ OK Status: healthy Models: 4 running, 0 suspended, 0 failed MODELS ✅ qwen3-vl-30b RUNNING port:8001 mem:55.0GB idle:42s ✅ bge-m3 RUNNING port:8002 mem:2.5GB idle:15s ✅ clip-vit RUNNING port:8003 mem:5.0GB idle:30s ❌ flux-dev FAILED port:8004 mem:35.0GB CONTAINERS ✅ sparkstation-qwen3-vl-30b Up 2 hours restarts:0 ✅ sparkstation-bge-m3 Up 2 hours restarts:0 ⚠️ sparkstation-flux-dev Exited (1) restarts:3 RECENT ERRORS (last 15min) [14:32:01] ERROR: Failed to health-check flux-dev: Connection refused [14:31:45] ERROR: Container sparkstation-flux-dev exited unexpectedly