vllm-bootstrap

Bootstrap an OpenAI-compatible vLLM server with validated dependencies and smoke tests.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

vLLM servers often fail to start or behave incorrectly due to dependency/version mismatches, wrong tensor-parallel settings, tool-calling parser incompatibilities, and GPU memory/OOM issues during model loading and request handling.

Core Features & Use Cases

  • Verified dependency matrix: Provides a tested set of package versions (vLLM, transformers, flashinfer-python/cubin, mistral_common) and warns about known-bad combinations.
  • Launch configuration guide: Defines a standard OpenAI-compatible server startup command and explains key flags like tensor parallel size (TP), max context length, and GPU memory utilization.
  • Failure-to-fix playbook: Covers common boot/runtime errors (DeepGEMM issues, flashinfer cubin mismatch, ReasoningEffort import errors, tool-call parser mismatches, NCCL TP hangs, OOM, port conflicts) with concrete remediation steps.
  • Tool-call parser mapping: Maps tool-call parser choices (hermes/mistral/pythonic/etc.) to model families to reduce “tool calls not parsed” failures.
  • Verification & monitoring: Includes curl-based smoke tests for /v1/models, chat completions, and tool calling plus guidance for log tailing and GPU metric checks.

Quick Start

Ask an AI to guide you to install the verified dependencies and launch an OpenAI-compatible vLLM server with a chosen tensor-parallel size and tool-call parser that matches your model, then run the /v1/models and chat/tool-calling smoke tests to confirm it is working.

Frequently Asked Questions about vllm-bootstrap

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

FAQPage Schema
How do I fix vLLM startup failures caused by dependency or version mismatches?

Fix vLLM startup failures by installing a verified dependency matrix that specifies compatible versions for vLLM, transformers, flashinfer, and mistral_common to avoid known-bad combinations.

How do I resolve GPU OOM errors during vLLM model loading or serving?

Resolve GPU OOM during vLLM model loading or serving by tuning GPU memory utilization and adjusting tensor-parallel size values like TP=1, TP=2, TP=4, or TP=8 to distribute memory load.

Why are tool calls not parsed correctly by my vLLM OpenAI-compatible server?

Tool calls are not parsed when the parser mismatches the model; map the correct tool-call parser such as hermes, mistral, or pythonic to your specific model family to resolve parsing failures.

What is the best way to verify a vLLM deployment is working after launch?

Verify a vLLM deployment is working by running curl-based smoke tests against the /v1/models endpoint and /v1/chat/completions, including tool-calling tests, plus logging and GPU metric checks.

Can I use tensor parallel size TP=8 with vLLM without getting NCCL hangs?

Using TP=8 with vLLM can cause NCCL hangs if configuration is incorrect; apply the failure-to-fix playbook to remediate NCCL TP hangs, flashinfer cubin mismatches, and port conflicts.

Does vLLM support OpenAI-compatible API endpoints for production serving?

vLLM supports OpenAI-compatible API endpoints for production serving, allowing you to boot a reliable server and test chat completions and tool calling through standard API requests.