[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6MB4X4NH4BCRGAAT16XQFY9":3,"skill-same:01M6MB4X4NH4BCRGAAT16XQFY9":98},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":23,"publishedAt":45,"linkOnly":46,"markdownContent":47,"markdownBody":48,"frontMatter":49,"refName":56,"commitSha":57,"skillDirectory":58,"forksCount":59,"repositoryHtmlUrl":60,"repositoryHomepageUrl":61,"ownerHtmlUrl":62,"ownerBlogUrl":63,"ownerDescription":64,"updatedAt":65,"install":66,"resources":79},"01M6MB4X4NH4BCRGAAT16XQFY9","serving-llms-vllm",null,"Serves LLMs with high throughput using vLLM's PagedAttention and continuous batching. Use when deploying production LLM APIs, optimizing inference latency\u002Fthroughput, or serving models with limited GPU memory. Supports OpenAI-compatible endpoints, quantization (GPTQ\u002FAWQ\u002FFP8), and tensor parallelism.","hashgraph-online\u002Fawesome-codex-plugins","hashgraph-online","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F160371962?v=4","01M6CNB6NRJVNNGN14TR01Q6D3","HOL (Hashgraph Online)","01M6JT1HSKKG9V68KQAQGBA7XP",1575,"MIT","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FKalarisLabs\u002Fresearch-agent-skills\u002Fskills\u002Fserving-llms-vllm\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000010","后端与接口","SCENARIO","使用场景",[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44],"serving","vLLM","llms","serving llms vllm","ops","when","batching","openai-compatible","throughput","GPTQ","AWQ","latency","use","api","Transformers","Inference Serving","FP8","openai api","openai","ml","memory","2026-11-10 10:12:30",false,"---\nname: serving-llms-vllm\ndescription: Serves LLMs with high throughput using vLLM's PagedAttention and continuous batching. Use when deploying production LLM APIs, optimizing inference latency\u002Fthroughput, or serving models with limited GPU memory. Supports OpenAI-compatible endpoints, quantization (GPTQ\u002FAWQ\u002FFP8), and tensor parallelism.\nlicense: MIT\nmetadata:\n  version: 1.0.0\n  category: ml-inference-and-ops\n  maintainer: Kalaris Labs\n  tags: vLLM, Inference Serving, PagedAttention, Continuous Batching, High Throughput, Production, OpenAI API, Quantization, Tensor Parallelism\n  dependencies: vllm, torch, transformers\n---\n\n# vLLM - High-Performance LLM Serving\n\n## Quick start\n\nvLLM achieves 24x higher throughput than standard transformers through PagedAttention (block-based KV cache) and continuous batching (mixing prefill\u002Fdecode requests).\n\n**Installation**:\n```bash\npip install vllm\n```\n\n**Basic offline inference**:\n```python\nfrom vllm import LLM, SamplingParams\n\nllm = LLM(model=\"meta-llama\u002FLlama-3-8B-Instruct\")\nsampling = SamplingParams(temperature=0.7, max_tokens=256)\n\noutputs = llm.generate([\"Explain quantum computing\"], sampling)\nprint(outputs[0].outputs[0].text)\n```\n\n**OpenAI-compatible server**:\n```bash\nvllm serve meta-llama\u002FLlama-3-8B-Instruct\n\n# Query with OpenAI SDK\npython -c \"\nfrom openai import OpenAI\nclient = OpenAI(base_url='http:\u002F\u002Flocalhost:8000\u002Fv1', api_key='EMPTY')\nprint(client.chat.completions.create(\n    model='meta-llama\u002FLlama-3-8B-Instruct',\n    messages=[{'role': 'user', 'content': 'Hello!'}]\n).choices[0].message.content)\n\"\n```\n\n## Common workflows\n\n### Workflow 1: Production API deployment\n\nCopy this checklist and track progress:\n\n```\nDeployment Progress:\n- [ ] Step 1: Configure server settings\n- [ ] Step 2: Test with limited traffic\n- [ ] Step 3: Enable monitoring\n- [ ] Step 4: Deploy to production\n- [ ] Step 5: Verify performance metrics\n```\n\n**Step 1: Configure server settings**\n\nChoose configuration based on your model size:\n\n```bash\n# For 7B-13B models on single GPU\nvllm serve meta-llama\u002FLlama-3-8B-Instruct \\\n  --gpu-memory-utilization 0.9 \\\n  --max-model-len 8192 \\\n  --port 8000\n\n# For 30B-70B models with tensor parallelism\nvllm serve meta-llama\u002FLlama-2-70b-hf \\\n  --tensor-parallel-size 4 \\\n  --gpu-memory-utilization 0.9 \\\n  --quantization awq \\\n  --port 8000\n\n# For production with caching and metrics\nvllm serve meta-llama\u002FLlama-3-8B-Instruct \\\n  --gpu-memory-utilization 0.9 \\\n  --enable-prefix-caching \\\n  --enable-metrics \\\n  --metrics-port 9090 \\\n  --port 8000 \\\n  --host 0.0.0.0\n```\n\n**Step 2: Test with limited traffic**\n\nRun load test before production:\n\n```bash\n# Install load testing tool\npip install locust\n\n# Create test_load.py with sample requests\n# Run: locust -f test_load.py --host http:\u002F\u002Flocalhost:8000\n```\n\nVerify TTFT (time to first token) \u003C 500ms and throughput > 100 req\u002Fsec.\n\n**Step 3: Enable monitoring**\n\nvLLM exposes Prometheus metrics on port 9090:\n\n```bash\ncurl http:\u002F\u002Flocalhost:9090\u002Fmetrics | grep vllm\n```\n\nKey metrics to monitor:\n- `vllm:time_to_first_token_seconds` - Latency\n- `vllm:num_requests_running` - Active requests\n- `vllm:gpu_cache_usage_perc` - KV cache utilization\n\n**Step 4: Deploy to production**\n\nUse Docker for consistent deployment:\n\n```bash\n# Run vLLM in Docker\ndocker run --gpus all -p 8000:8000 \\\n  vllm\u002Fvllm-openai:latest \\\n  --model meta-llama\u002FLlama-3-8B-Instruct \\\n  --gpu-memory-utilization 0.9 \\\n  --enable-prefix-caching\n```\n\n**Step 5: Verify performance metrics**\n\nCheck that deployment meets targets:\n- TTFT \u003C 500ms (for short prompts)\n- Throughput > target req\u002Fsec\n- GPU utilization > 80%\n- No OOM errors in logs\n\n### Workflow 2: Offline batch inference\n\nFor processing large datasets without server overhead.\n\nCopy this checklist:\n\n```\nBatch Processing:\n- [ ] Step 1: Prepare input data\n- [ ] Step 2: Configure LLM engine\n- [ ] Step 3: Run batch inference\n- [ ] Step 4: Process results\n```\n\n**Step 1: Prepare input data**\n\n```python\n# Load prompts from file\nprompts = []\nwith open(\"prompts.txt\") as f:\n    prompts = [line.strip() for line in f]\n\nprint(f\"Loaded {len(prompts)} prompts\")\n```\n\n**Step 2: Configure LLM engine**\n\n```python\nfrom vllm import LLM, SamplingParams\n\nllm = LLM(\n    model=\"meta-llama\u002FLlama-3-8B-Instruct\",\n    tensor_parallel_size=2,  # Use 2 GPUs\n    gpu_memory_utilization=0.9,\n    max_model_len=4096\n)\n\nsampling = SamplingParams(\n    temperature=0.7,\n    top_p=0.95,\n    max_tokens=512,\n    stop=[\"\u003C\u002Fs>\", \"\\n\\n\"]\n)\n```\n\n**Step 3: Run batch inference**\n\nvLLM automatically batches requests for efficiency:\n\n```python\n# Process all prompts in one call\noutputs = llm.generate(prompts, sampling)\n\n# vLLM handles batching internally\n# No need to manually chunk prompts\n```\n\n**Step 4: Process results**\n\n```python\n# Extract generated text\nresults = []\nfor output in outputs:\n    prompt = output.prompt\n    generated = output.outputs[0].text\n    results.append({\n        \"prompt\": prompt,\n        \"generated\": generated,\n        \"tokens\": len(output.outputs[0].token_ids)\n    })\n\n# Save to file\nimport json\nwith open(\"results.jsonl\", \"w\") as f:\n    for result in results:\n        f.write(json.dumps(result) + \"\\n\")\n\nprint(f\"Processed {len(results)} prompts\")\n```\n\n### Workflow 3: Quantized model serving\n\nFit large models in limited GPU memory.\n\n```\nQuantization Setup:\n- [ ] Step 1: Choose quantization method\n- [ ] Step 2: Find or create quantized model\n- [ ] Step 3: Launch with quantization flag\n- [ ] Step 4: Verify accuracy\n```\n\n**Step 1: Choose quantization method**\n\n- **AWQ**: Best for 70B models, minimal accuracy loss\n- **GPTQ**: Wide model support, good compression\n- **FP8**: Fastest on H100 GPUs\n\n**Step 2: Find or create quantized model**\n\nUse pre-quantized models from HuggingFace:\n\n```bash\n# Search for AWQ models\n# Example: TheBloke\u002FLlama-2-70B-AWQ\n```\n\n**Step 3: Launch with quantization flag**\n\n```bash\n# Using pre-quantized model\nvllm serve TheBloke\u002FLlama-2-70B-AWQ \\\n  --quantization awq \\\n  --tensor-parallel-size 1 \\\n  --gpu-memory-utilization 0.95\n\n# Results: 70B model in ~40GB VRAM\n```\n\n**Step 4: Verify accuracy**\n\nTest outputs match expected quality:\n\n```python\n# Compare quantized vs non-quantized responses\n# Verify task-specific performance unchanged\n```\n\n## When to use vs alternatives\n\n**Use vLLM when:**\n- Deploying production LLM APIs (100+ req\u002Fsec)\n- Serving OpenAI-compatible endpoints\n- Limited GPU memory but need large models\n- Multi-user applications (chatbots, assistants)\n- Need low latency with high throughput\n\n**Use alternatives instead:**\n- **llama.cpp**: CPU\u002Fedge inference, single-user\n- **HuggingFace transformers**: Research, prototyping, one-off generation\n- **TensorRT-LLM**: NVIDIA-only, need absolute maximum performance\n- **Text-Generation-Inference**: Already in HuggingFace ecosystem\n\n## Common issues\n\n**Issue: Out of memory during model loading**\n\nReduce memory usage:\n```bash\nvllm serve MODEL \\\n  --gpu-memory-utilization 0.7 \\\n  --max-model-len 4096\n```\n\nOr use quantization:\n```bash\nvllm serve MODEL --quantization awq\n```\n\n**Issue: Slow first token (TTFT > 1 second)**\n\nEnable prefix caching for repeated prompts:\n```bash\nvllm serve MODEL --enable-prefix-caching\n```\n\nFor long prompts, enable chunked prefill:\n```bash\nvllm serve MODEL --enable-chunked-prefill\n```\n\n**Issue: Model not found error**\n\nUse `--trust-remote-code` for custom models:\n```bash\nvllm serve MODEL --trust-remote-code\n```\n\n**Issue: Low throughput (\u003C50 req\u002Fsec)**\n\nIncrease concurrent sequences:\n```bash\nvllm serve MODEL --max-num-seqs 512\n```\n\nCheck GPU utilization with `nvidia-smi` - should be >80%.\n\n**Issue: Inference slower than expected**\n\nVerify tensor parallelism uses power of 2 GPUs:\n```bash\nvllm serve MODEL --tensor-parallel-size 4  # Not 3\n```\n\nEnable speculative decoding for faster generation:\n```bash\nvllm serve MODEL --speculative-model DRAFT_MODEL\n```\n\n## Advanced topics\n\n**Server deployment patterns**: See [references\u002Fserver-deployment.md](references\u002Fserver-deployment.md) for Docker, Kubernetes, and load balancing configurations.\n\n**Performance optimization**: See [references\u002Foptimization.md](references\u002Foptimization.md) for PagedAttention tuning, continuous batching details, and benchmark results.\n\n**Quantization guide**: See [references\u002Fquantization.md](references\u002Fquantization.md) for AWQ\u002FGPTQ\u002FFP8 setup, model preparation, and accuracy comparisons.\n\n**Troubleshooting**: See [references\u002Ftroubleshooting.md](references\u002Ftroubleshooting.md) for detailed error messages, debugging steps, and performance diagnostics.\n\n## Hardware requirements\n\n- **Small models (7B-13B)**: 1x A10 (24GB) or A100 (40GB)\n- **Medium models (30B-40B)**: 2x A100 (40GB) with tensor parallelism\n- **Large models (70B+)**: 4x A100 (40GB) or 2x A100 (80GB), use AWQ\u002FGPTQ\n\nSupported platforms: NVIDIA (primary), AMD ROCm, Intel GPUs, TPUs\n\n## Resources\n\n- Official docs: https:\u002F\u002Fdocs.vllm.ai\n- GitHub: https:\u002F\u002Fgithub.com\u002Fvllm-project\u002Fvllm\n- Paper: \"Efficient Memory Management for Large Language Model Serving with PagedAttention\" (SOSP 2023)\n- Community: https:\u002F\u002Fdiscuss.vllm.ai\n\n## Agent operating procedure\n\n1. **Check the environment.** Confirm hardware, framework and server versions, model format, and expected load.\n2. **Pin down the inputs.** Confirm formats, identifiers and parameters from the data or the user. Ask rather than guess any value that changes the result.\n3. **Run a small version first.** Serve or log a single request or run end to end before scaling.\n4. **Execute the full task** using the instructions and references above.\n5. **Validate the result.** Measure latency, throughput and output correctness against a reference; check resource usage and costs.\n6. **Report.** State what was run (versions, commands, parameters), what was checked, and what is still uncertain.\n\n| If this happens | Do this |\n|---|---|\n| The server fails to start or OOMs | Check model size versus memory, quantization and parallelism settings. |\n| A function, flag or endpoint in these instructions is missing in the installed version | Check the installed version's own documentation (`help()`, `--help`, official docs), adapt, and tell the user. Never invent an API. |\n| A required input, identifier or parameter is ambiguous | Ask the user, or state the assumption explicitly before running. |\n\n**Integrity rules**\n\n- Never fabricate results, parameters, identifiers, citations or statistics. If something cannot be run or verified, say so plainly.\n- Do not expose services or credentials publicly; confirm cloud costs before provisioning.\n- Treat version-specific details here as possibly outdated: confirm them against the official documentation for the installed version.\n- Ask before actions that cost money, consume shared GPUs or cloud quota, touch personal or patient data, or cannot be undone.\n\n## Related skills\n\n- `tensorrt-llm`: Optimizes LLM inference with NVIDIA TensorRT for maximum throughput and lowest latency.\n- `awq-quantization`: Activation-aware weight quantization for 4-bit LLM compression with 3x speedup and minimal accuracy loss.\n- `gptq`: Quantizes LLMs to 4-bit (also 3-bit) with GPTQ using group-wise quantization (group size 128 by default), via AutoGPTQ and transformers.\n","# vLLM - High-Performance LLM Serving\n\n## Quick start\n\nvLLM achieves 24x higher throughput than standard transformers through PagedAttention (block-based KV cache) and continuous batching (mixing prefill\u002Fdecode requests).\n\n**Installation**:\n```bash\npip install vllm\n```\n\n**Basic offline inference**:\n```python\nfrom vllm import LLM, SamplingParams\n\nllm = LLM(model=\"meta-llama\u002FLlama-3-8B-Instruct\")\nsampling = SamplingParams(temperature=0.7, max_tokens=256)\n\noutputs = llm.generate([\"Explain quantum computing\"], sampling)\nprint(outputs[0].outputs[0].text)\n```\n\n**OpenAI-compatible server**:\n```bash\nvllm serve meta-llama\u002FLlama-3-8B-Instruct\n\n# Query with OpenAI SDK\npython -c \"\nfrom openai import OpenAI\nclient = OpenAI(base_url='http:\u002F\u002Flocalhost:8000\u002Fv1', api_key='EMPTY')\nprint(client.chat.completions.create(\n    model='meta-llama\u002FLlama-3-8B-Instruct',\n    messages=[{'role': 'user', 'content': 'Hello!'}]\n).choices[0].message.content)\n\"\n```\n\n## Common workflows\n\n### Workflow 1: Production API deployment\n\nCopy this checklist and track progress:\n\n```\nDeployment Progress:\n- [ ] Step 1: Configure server settings\n- [ ] Step 2: Test with limited traffic\n- [ ] Step 3: Enable monitoring\n- [ ] Step 4: Deploy to production\n- [ ] Step 5: Verify performance metrics\n```\n\n**Step 1: Configure server settings**\n\nChoose configuration based on your model size:\n\n```bash\n# For 7B-13B models on single GPU\nvllm serve meta-llama\u002FLlama-3-8B-Instruct \\\n  --gpu-memory-utilization 0.9 \\\n  --max-model-len 8192 \\\n  --port 8000\n\n# For 30B-70B models with tensor parallelism\nvllm serve meta-llama\u002FLlama-2-70b-hf \\\n  --tensor-parallel-size 4 \\\n  --gpu-memory-utilization 0.9 \\\n  --quantization awq \\\n  --port 8000\n\n# For production with caching and metrics\nvllm serve meta-llama\u002FLlama-3-8B-Instruct \\\n  --gpu-memory-utilization 0.9 \\\n  --enable-prefix-caching \\\n  --enable-metrics \\\n  --metrics-port 9090 \\\n  --port 8000 \\\n  --host 0.0.0.0\n```\n\n**Step 2: Test with limited traffic**\n\nRun load test before production:\n\n```bash\n# Install load testing tool\npip install locust\n\n# Create test_load.py with sample requests\n# Run: locust -f test_load.py --host http:\u002F\u002Flocalhost:8000\n```\n\nVerify TTFT (time to first token) \u003C 500ms and throughput > 100 req\u002Fsec.\n\n**Step 3: Enable monitoring**\n\nvLLM exposes Prometheus metrics on port 9090:\n\n```bash\ncurl http:\u002F\u002Flocalhost:9090\u002Fmetrics | grep vllm\n```\n\nKey metrics to monitor:\n- `vllm:time_to_first_token_seconds` - Latency\n- `vllm:num_requests_running` - Active requests\n- `vllm:gpu_cache_usage_perc` - KV cache utilization\n\n**Step 4: Deploy to production**\n\nUse Docker for consistent deployment:\n\n```bash\n# Run vLLM in Docker\ndocker run --gpus all -p 8000:8000 \\\n  vllm\u002Fvllm-openai:latest \\\n  --model meta-llama\u002FLlama-3-8B-Instruct \\\n  --gpu-memory-utilization 0.9 \\\n  --enable-prefix-caching\n```\n\n**Step 5: Verify performance metrics**\n\nCheck that deployment meets targets:\n- TTFT \u003C 500ms (for short prompts)\n- Throughput > target req\u002Fsec\n- GPU utilization > 80%\n- No OOM errors in logs\n\n### Workflow 2: Offline batch inference\n\nFor processing large datasets without server overhead.\n\nCopy this checklist:\n\n```\nBatch Processing:\n- [ ] Step 1: Prepare input data\n- [ ] Step 2: Configure LLM engine\n- [ ] Step 3: Run batch inference\n- [ ] Step 4: Process results\n```\n\n**Step 1: Prepare input data**\n\n```python\n# Load prompts from file\nprompts = []\nwith open(\"prompts.txt\") as f:\n    prompts = [line.strip() for line in f]\n\nprint(f\"Loaded {len(prompts)} prompts\")\n```\n\n**Step 2: Configure LLM engine**\n\n```python\nfrom vllm import LLM, SamplingParams\n\nllm = LLM(\n    model=\"meta-llama\u002FLlama-3-8B-Instruct\",\n    tensor_parallel_size=2,  # Use 2 GPUs\n    gpu_memory_utilization=0.9,\n    max_model_len=4096\n)\n\nsampling = SamplingParams(\n    temperature=0.7,\n    top_p=0.95,\n    max_tokens=512,\n    stop=[\"\u003C\u002Fs>\", \"\\n\\n\"]\n)\n```\n\n**Step 3: Run batch inference**\n\nvLLM automatically batches requests for efficiency:\n\n```python\n# Process all prompts in one call\noutputs = llm.generate(prompts, sampling)\n\n# vLLM handles batching internally\n# No need to manually chunk prompts\n```\n\n**Step 4: Process results**\n\n```python\n# Extract generated text\nresults = []\nfor output in outputs:\n    prompt = output.prompt\n    generated = output.outputs[0].text\n    results.append({\n        \"prompt\": prompt,\n        \"generated\": generated,\n        \"tokens\": len(output.outputs[0].token_ids)\n    })\n\n# Save to file\nimport json\nwith open(\"results.jsonl\", \"w\") as f:\n    for result in results:\n        f.write(json.dumps(result) + \"\\n\")\n\nprint(f\"Processed {len(results)} prompts\")\n```\n\n### Workflow 3: Quantized model serving\n\nFit large models in limited GPU memory.\n\n```\nQuantization Setup:\n- [ ] Step 1: Choose quantization method\n- [ ] Step 2: Find or create quantized model\n- [ ] Step 3: Launch with quantization flag\n- [ ] Step 4: Verify accuracy\n```\n\n**Step 1: Choose quantization method**\n\n- **AWQ**: Best for 70B models, minimal accuracy loss\n- **GPTQ**: Wide model support, good compression\n- **FP8**: Fastest on H100 GPUs\n\n**Step 2: Find or create quantized model**\n\nUse pre-quantized models from HuggingFace:\n\n```bash\n# Search for AWQ models\n# Example: TheBloke\u002FLlama-2-70B-AWQ\n```\n\n**Step 3: Launch with quantization flag**\n\n```bash\n# Using pre-quantized model\nvllm serve TheBloke\u002FLlama-2-70B-AWQ \\\n  --quantization awq \\\n  --tensor-parallel-size 1 \\\n  --gpu-memory-utilization 0.95\n\n# Results: 70B model in ~40GB VRAM\n```\n\n**Step 4: Verify accuracy**\n\nTest outputs match expected quality:\n\n```python\n# Compare quantized vs non-quantized responses\n# Verify task-specific performance unchanged\n```\n\n## When to use vs alternatives\n\n**Use vLLM when:**\n- Deploying production LLM APIs (100+ req\u002Fsec)\n- Serving OpenAI-compatible endpoints\n- Limited GPU memory but need large models\n- Multi-user applications (chatbots, assistants)\n- Need low latency with high throughput\n\n**Use alternatives instead:**\n- **llama.cpp**: CPU\u002Fedge inference, single-user\n- **HuggingFace transformers**: Research, prototyping, one-off generation\n- **TensorRT-LLM**: NVIDIA-only, need absolute maximum performance\n- **Text-Generation-Inference**: Already in HuggingFace ecosystem\n\n## Common issues\n\n**Issue: Out of memory during model loading**\n\nReduce memory usage:\n```bash\nvllm serve MODEL \\\n  --gpu-memory-utilization 0.7 \\\n  --max-model-len 4096\n```\n\nOr use quantization:\n```bash\nvllm serve MODEL --quantization awq\n```\n\n**Issue: Slow first token (TTFT > 1 second)**\n\nEnable prefix caching for repeated prompts:\n```bash\nvllm serve MODEL --enable-prefix-caching\n```\n\nFor long prompts, enable chunked prefill:\n```bash\nvllm serve MODEL --enable-chunked-prefill\n```\n\n**Issue: Model not found error**\n\nUse `--trust-remote-code` for custom models:\n```bash\nvllm serve MODEL --trust-remote-code\n```\n\n**Issue: Low throughput (\u003C50 req\u002Fsec)**\n\nIncrease concurrent sequences:\n```bash\nvllm serve MODEL --max-num-seqs 512\n```\n\nCheck GPU utilization with `nvidia-smi` - should be >80%.\n\n**Issue: Inference slower than expected**\n\nVerify tensor parallelism uses power of 2 GPUs:\n```bash\nvllm serve MODEL --tensor-parallel-size 4  # Not 3\n```\n\nEnable speculative decoding for faster generation:\n```bash\nvllm serve MODEL --speculative-model DRAFT_MODEL\n```\n\n## Advanced topics\n\n**Server deployment patterns**: See [references\u002Fserver-deployment.md](references\u002Fserver-deployment.md) for Docker, Kubernetes, and load balancing configurations.\n\n**Performance optimization**: See [references\u002Foptimization.md](references\u002Foptimization.md) for PagedAttention tuning, continuous batching details, and benchmark results.\n\n**Quantization guide**: See [references\u002Fquantization.md](references\u002Fquantization.md) for AWQ\u002FGPTQ\u002FFP8 setup, model preparation, and accuracy comparisons.\n\n**Troubleshooting**: See [references\u002Ftroubleshooting.md](references\u002Ftroubleshooting.md) for detailed error messages, debugging steps, and performance diagnostics.\n\n## Hardware requirements\n\n- **Small models (7B-13B)**: 1x A10 (24GB) or A100 (40GB)\n- **Medium models (30B-40B)**: 2x A100 (40GB) with tensor parallelism\n- **Large models (70B+)**: 4x A100 (40GB) or 2x A100 (80GB), use AWQ\u002FGPTQ\n\nSupported platforms: NVIDIA (primary), AMD ROCm, Intel GPUs, TPUs\n\n## Resources\n\n- Official docs: https:\u002F\u002Fdocs.vllm.ai\n- GitHub: https:\u002F\u002Fgithub.com\u002Fvllm-project\u002Fvllm\n- Paper: \"Efficient Memory Management for Large Language Model Serving with PagedAttention\" (SOSP 2023)\n- Community: https:\u002F\u002Fdiscuss.vllm.ai\n\n## Agent operating procedure\n\n1. **Check the environment.** Confirm hardware, framework and server versions, model format, and expected load.\n2. **Pin down the inputs.** Confirm formats, identifiers and parameters from the data or the user. Ask rather than guess any value that changes the result.\n3. **Run a small version first.** Serve or log a single request or run end to end before scaling.\n4. **Execute the full task** using the instructions and references above.\n5. **Validate the result.** Measure latency, throughput and output correctness against a reference; check resource usage and costs.\n6. **Report.** State what was run (versions, commands, parameters), what was checked, and what is still uncertain.\n\n| If this happens | Do this |\n|---|---|\n| The server fails to start or OOMs | Check model size versus memory, quantization and parallelism settings. |\n| A function, flag or endpoint in these instructions is missing in the installed version | Check the installed version's own documentation (`help()`, `--help`, official docs), adapt, and tell the user. Never invent an API. |\n| A required input, identifier or parameter is ambiguous | Ask the user, or state the assumption explicitly before running. |\n\n**Integrity rules**\n\n- Never fabricate results, parameters, identifiers, citations or statistics. If something cannot be run or verified, say so plainly.\n- Do not expose services or credentials publicly; confirm cloud costs before provisioning.\n- Treat version-specific details here as possibly outdated: confirm them against the official documentation for the installed version.\n- Ask before actions that cost money, consume shared GPUs or cloud quota, touch personal or patient data, or cannot be undone.\n\n## Related skills\n\n- `tensorrt-llm`: Optimizes LLM inference with NVIDIA TensorRT for maximum throughput and lowest latency.\n- `awq-quantization`: Activation-aware weight quantization for 4-bit LLM compression with 3x speedup and minimal accuracy loss.\n- `gptq`: Quantizes LLMs to 4-bit (also 3-bit) with GPTQ using group-wise quantization (group size 128 by default), via AutoGPTQ and transformers.\n",{"name":5,"license":15,"metadata":50,"description":7},{"tags":51,"version":52,"category":53,"maintainer":54,"dependencies":55},"vLLM, Inference Serving, PagedAttention, Continuous Batching, High Throughput, Production, OpenAI API, Quantization, Tensor Parallelism","1.0.0","ml-inference-and-ops","Kalaris Labs","vllm, torch, transformers","main","2b63f856ce19c2a797929cacabd9e0fc936812fa","plugins\u002FKalarisLabs\u002Fresearch-agent-skills\u002Fskills\u002Fserving-llms-vllm",491,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins","https:\u002F\u002Fhol.org\u002Fplugins\u002Fbest-codex-plugins","https:\u002F\u002Fgithub.com\u002Fhashgraph-online","https:\u002F\u002Fhol.org","Open-source standards and developer tools for interoperable AI agents: discovery, identity, communication, payments, privacy and security.","2026-11-14 14:06:13",{"source":8,"skillName":5,"commands":67,"prompt":77,"zipAvailable":78},[68,71,74],{"tool":69,"command":70},"npx","npx skills add hashgraph-online\u002Fawesome-codex-plugins --skill serving-llms-vllm",{"tool":72,"command":73},"bunx","bunx skills add hashgraph-online\u002Fawesome-codex-plugins --skill serving-llms-vllm",{"tool":75,"command":76},"pnpm","pnpm dlx skills add hashgraph-online\u002Fawesome-codex-plugins --skill serving-llms-vllm","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FKalarisLabs\u002Fresearch-agent-skills\u002Fskills\u002Fserving-llms-vllm\u002FSKILL.md",true,[80,86,90,94],{"path":81,"resourceType":82,"resourceTypeDesc":83,"sizeBytes":84,"sourceHtmlUrl":85},"references\u002Foptimization.md","REFERENCE","参考文档",5769,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FKalarisLabs\u002Fresearch-agent-skills\u002Fskills\u002Fserving-llms-vllm\u002Freferences\u002Foptimization.md",{"path":87,"resourceType":82,"resourceTypeDesc":83,"sizeBytes":88,"sourceHtmlUrl":89},"references\u002Fquantization.md",6746,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FKalarisLabs\u002Fresearch-agent-skills\u002Fskills\u002Fserving-llms-vllm\u002Freferences\u002Fquantization.md",{"path":91,"resourceType":82,"resourceTypeDesc":83,"sizeBytes":92,"sourceHtmlUrl":93},"references\u002Fserver-deployment.md",5252,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FKalarisLabs\u002Fresearch-agent-skills\u002Fskills\u002Fserving-llms-vllm\u002Freferences\u002Fserver-deployment.md",{"path":95,"resourceType":82,"resourceTypeDesc":83,"sizeBytes":96,"sourceHtmlUrl":97},"references\u002Ftroubleshooting.md",9037,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FKalarisLabs\u002Fresearch-agent-skills\u002Fskills\u002Fserving-llms-vllm\u002Freferences\u002Ftroubleshooting.md",[99,108,116,124,132,140],{"skillNo":100,"name":101,"nameZh":6,"description":102,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":103,"sourceHtmlUrl":104,"categories":105,"keywords":106,"publishedAt":107},"01M7DV332YQMGD8WTRJ9DZQXTB","worktable-review-with-annotations","Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":109,"name":110,"nameZh":6,"description":111,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":112,"sourceHtmlUrl":113,"categories":114,"keywords":115,"publishedAt":107},"01M7DV2YGHCZVBEB1AHYB6CGHE","worktable-find-and-synthesize-context","Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FSKILL.md",[],[],{"skillNo":117,"name":118,"nameZh":6,"description":119,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":120,"sourceHtmlUrl":121,"categories":122,"keywords":123,"publishedAt":107},"01M7DV2TQN1H11ME2SAF9MXN7V","worktable-create-or-update-docs","Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FSKILL.md",[],[],{"skillNo":125,"name":126,"nameZh":6,"description":127,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":128,"sourceHtmlUrl":129,"categories":130,"keywords":131,"publishedAt":107},"01M7DV2NE452NEA8TXATKSNAJH","worktable-create-or-manage-records","Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FSKILL.md",[],[],{"skillNo":133,"name":134,"nameZh":6,"description":135,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":136,"sourceHtmlUrl":137,"categories":138,"keywords":139,"publishedAt":107},"01M7DV2HENRBR2KSCVM064WH0Y","worktable-create-or-manage-interactive-html","Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FSKILL.md",[],[],{"skillNo":141,"name":142,"nameZh":6,"description":143,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":144,"sourceHtmlUrl":145,"categories":146,"keywords":147,"publishedAt":107},"01M7DV2CADR5R7RQFFYPNAGR9Y","worktable-collaborate-threads","Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FSKILL.md",[],[]]