Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
huggingface avatar

Inference Server

  • 6 installs
  • Updated March 19, 2026
  • huggingface/prime-rl

inference-server skill documents Start and test the prime-rl inference server.

About

inference-server skill documents Start and test the prime-rl inference server. Use when asked to run inference, start vLLM, test a model, or launch the inference server.. name: inference-server description: Start and test the prime-rl inference server. Use when asked to run inference, start vLLM, test a model, or launch the inference server.

  • Start and test the prime-rl inference server.
  • Platform-specific setup patterns for inference-server.
  • Evidence-backed steps from upstream SKILL.md.
  • When-to-use criteria for inference-server versus alternatives.

Inference Server by the numbers

  • 6 all-time installs (skills.sh)
  • Ranked #1,588 of 2,064 Data Science & ML skills by installs in the Skillselion catalog
  • Data as of Aug 2, 2026 (Skillselion catalog sync)
At a glance

inference-server capabilities & compatibility

Capabilities
inference server quick start · inference server when to use guidance · inference server integration patterns
Use cases
research
From the docs

What inference-server says it does

uv run inference @ path/to/config.toml
SKILL.md
uv run inference --model.name Qwen/Qwen3-0.6B --model.max_model_len 2048 --model.enforce_eager
SKILL.md
npx skills add https://github.com/huggingface/prime-rl --skill inference-server

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs6
Last updatedMarch 19, 2026
Repositoryhuggingface/prime-rl

How do I use inference-server correctly?

Start and test the prime-rl inference server. Use when asked to run inference, start vLLM, test a model, or launch the inference server.

Who is it for?

Teams implementing inference-server workflows from the catalog.

Skip if: Skip when requirements clearly match a different specialized stack.

When should I use this skill?

User asks about inference-server, start and test the prime-rl inference server. use when asked to run inference, start vllm,.

What you get

Working inference-server setup with validated configuration and next steps.

Files

SKILL.mdMarkdownGitHub ↗

Inference Server

Starting the server

Always use the inference entry point — never vllm serve or python -m vllm.entrypoints.openai.api_server directly. The entry point runs setup_vllm_env() which configures environment variables (LoRA, multiprocessing) before vLLM is imported.

# With a TOML config
uv run inference @ path/to/config.toml

# With CLI overrides
uv run inference --model.name Qwen/Qwen3-0.6B --model.max_model_len 2048 --model.enforce_eager

# Combined
uv run inference @ path/to/config.toml --server.port 8001 --gpu-memory-utilization 0.5

SLURM scheduling

The inference entrypoint supports optional SLURM scheduling, following the same patterns as SFT and RL.

Single-node SLURM

# inference_slurm.toml
output_dir = "/shared/outputs/my-inference"

[model]
name = "Qwen/Qwen3-8B"

[parallel]
tp = 8

[slurm]
job_name = "my-inference"
partition = "cluster"
uv run inference @ inference_slurm.toml

Multi-node SLURM (independent vLLM replicas)

Each node runs an independent vLLM instance. No cross-node parallelism — TP and DP must fit within a single node's GPUs.

# inference_multinode.toml
output_dir = "/shared/outputs/my-inference"

[model]
name = "PrimeIntellect/INTELLECT-3-RL-600"

[parallel]
tp = 8
dp = 1

[deployment]
type = "multi_node"
num_nodes = 4
gpus_per_node = 8

[slurm]
job_name = "my-inference"
partition = "cluster"

Dry run

Add dry_run = true to generate the sbatch script without submitting:

uv run inference @ config.toml --dry-run true

Custom endpoints

The server extends vLLM with:

  • /v1/chat/completions/tokens — accepts token IDs as prompt input (used by multi-turn RL rollouts)
  • /update_weights — hot-reload model weights from the trainer
  • /load_lora_adapter — load LoRA adapters at runtime
  • /init_broadcaster — initialize weight broadcast for distributed training

Testing the server

curl http://localhost:8000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Qwen/Qwen3-0.6B",
    "messages": [{"role": "user", "content": "Hi"}],
    "max_tokens": 50
  }'

Key files

  • src/prime_rl/entrypoints/inference.py — entrypoint with local/SLURM routing
  • src/prime_rl/inference/server.py — vLLM env setup
  • src/prime_rl/configs/inference.pyInferenceConfig and all sub-configs
  • src/prime_rl/inference/vllm/server.py — FastAPI routes and vLLM monkey-patches
  • src/prime_rl/templates/inference.sbatch.j2 — SLURM template (handles both single and multi-node)
  • configs/debug/infer.toml — minimal debug config

Related skills

FAQ

What does inference-server do?

inference-server skill documents Start and test the prime-rl inference server.

When should I use inference-server?

User asks about inference-server, start and test the prime-rl inference server. use when asked to run inference, start vllm,.

Is this skill safe to install?

Review the Security Audits panel on this page before installing in production.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.