gem-llm-supervisor

Start, stop, restart, and health-check vLLM instances with Gateway and Admin UI.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/saintgo7/claude-skills --skill gem-llm-supervisor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gem-llm-supervisor
Source: https://github.com/saintgo7/claude-skills/tree/main/gem-llm-supervisor
Command: npx skills add https://github.com/saintgo7/claude-skills --skill gem-llm-supervisor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It eliminates the operational friction of manually starting, stopping, and recovering a multi-service GEM-LLM deployment that includes dual vLLM instances plus a Gateway and Admin UI.

Core Features & Use Cases

  • Integrated start/stop/restart: Starts vLLM (two instances), waits for model readiness by polling, then brings up Gateway and Admin UI in the correct order.
  • Health-based status visibility: Provides a consolidated status check across local services and the external Cloudflare tunnel endpoint.
  • Production-style troubleshooting guidance: Points you to the most likely failure causes (ports, Cloudflare down, service-specific errors, GPU PID leftovers) and includes restart/maintenance playbooks.

Quick Start

Run the skill by executing install.sh with gem-llm-supervisor.

Frequently Asked Questions about gem-llm-supervisor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I start dual vLLM instances and a gateway together in one command?

To start dual vLLM instances with a gateway and admin UI, the supervisor enforces model readiness by polling with a timeout before bringing up dependent services in the correct order.

What is the best way to check if my vLLM services and Cloudflare tunnel are healthy?

A consolidated health check verifies local services and the external Cloudflare tunnel endpoint by running port-specific checks and providing deterministic status logs across the full stack.

Why does my vLLM stack fail to start after a system reboot?

vLLM stack startup failures after a reboot often stem from GPU PID leftovers, occupied ports, or a down Cloudflare tunnel, which the supervisor addresses through automated recovery and troubleshooting playbooks.

How do I troubleshoot which service is down in my multi-service LLM deployment?

Troubleshooting a multi-service LLM deployment involves checking consolidated health status, identifying service-specific errors, and inspecting port availability to pinpoint the exact failure point.

Can I restart the entire vLLM, gateway, and admin UI stack without manual intervention?

Yes, you can restart the full stack automatically by executing the supervisor command, which handles stopping existing processes and bringing the dual vLLM, gateway, and admin UI back up sequentially.

When do I need to use a supervisor for my vLLM and gateway deployment?

You need a supervisor for integrated orchestration when managing multi-service deployments, ensuring correct startup sequencing, and diagnosing reachability issues across local services and external tunnels.