\n
\nYou can spin up a private, OpenAI-compatible LLM endpoint on Hugging Face infrastructure with a single command \u2014 no servers to provision, no Kubernetes, pay-per-second. Once it’s up, you can query it from your laptop, a notebook, or anywhere else.
\nIt’s the quickest way to stand up a model for tests, evals, or batch generation. (If you’re after a managed, production-ready service instead, that’s what Inference Endpoints are for \u2014 more on when to pick which at the end.)
\nHere’s the whole thing end to end.<\/p>\n
\t\tPrerequisites<\/p>\n
A payment method or a positive prepaid credit balance (Jobs is billed per\u2011minute by hardware usage).
\nhuggingface_hub >= 1.20.0: pip install -U “huggingface_hub>=1.20.0”.
\nLogged in locally: hf auth login.<\/p>\n
\t\tLaunch the server<\/p>\n
hf jobs run is docker run for HF infrastructure. We use the official vllm\/vllm-openai image, ask for a GPU with –flavor, and expose vLLM’s port with –expose:
\nhf jobs run –flavor a10g-large –expose 8000 –timeout 2h \\
\n vllm\/vllm-openai:latest \\
\n vllm serve Qwen\/Qwen3-4B –host 0.0.0.0 –port 8000<\/p>\n
–expose 8000 routes the container’s port through HF’s public jobs proxy (see the Serve Models guide for the full reference). The command prints the URL your server is reachable at:
\n\u2713 Job started
\n id: 6a381ca1953ed90bfb947332
\n url: https:\/\/huggingface.co\/jobs\/qgallouedec\/6a381ca1953ed90bfb947332
\nHint: Exposed ports are reachable at (requires an HF token with read access to the job):
\n https:\/\/6a381ca1953ed90bfb947332–8000.hf.jobs<\/p>\n
6a381ca1953ed90bfb947332 is your job ID. Keep track of it, we’ll need it. We’ll use as a placeholder for it in the rest of the post.
\nGive it a couple of minutes to download weights and boot. When the logs show Application startup complete, you’re live.<\/p>\n
\t\tQuery it from anywhere<\/p>\n
vLLM speaks the OpenAI API, and every request just needs your HF token as a bearer token. The quickest way to hit it is curl:
\ncurl https:\/\/–8000.hf.jobs\/v1\/chat\/completions \\
\n -H “Authorization: Bearer $(hf auth token)” \\
\n -H “Content-Type: application\/json” \\
\n -d ‘{
\n “model”: “Qwen\/Qwen3-4B”,
\n “messages”: ({“role”: “user”, “content”: “Hello!”}),
\n “chat_template_kwargs”: {“enable_thinking”: false}
\n }’<\/p>\n
which returns the usual OpenAI-style JSON, with choices(0).message.content holding “Hello! How can I assist you today? \ud83d\ude0a”.
\nOr, from Python, point the OpenAI client at the exposed URL and pass the token as the API key:
\nfrom huggingface_hub import get_token
\nfrom openai import OpenAI<\/p>\n
client = OpenAI(
\n base_url=”https:\/\/–8000.hf.jobs\/v1″,
\n api_key=get_token(),
\n)
\nresp = client.chat.completions.create(
\n model=”Qwen\/Qwen3-4B”,
\n messages=({“role”: “user”, “content”: “Hello!”}),
\n extra_body={“chat_template_kwargs”: {“enable_thinking”: False}},
\n)
\nprint(resp.choices(0).message.content)<\/p>\n
Hello! How can I assist you today? \ud83d\ude0a<\/p>\n
Quick health check before you start: curl https:\/\/–8000.hf.jobs\/v1\/models -H “Authorization: Bearer $(hf auth token)” should list the model.<\/p>\n
\ud83d\udd10 The endpoint is gated, not public. Every request must carry an HF token with read access to the job’s namespace. A plain browser visit will be rejected. In effect, the jobs proxy is your API gate: access is scoped to you (and your org). That’s fine for private use, but treat the URL accordingly: don’t share it expecting it to be open, and don’t paste your token into untrusted places. If you need finer-grained or public access, put a proper gateway in front instead. Or see HF Jobs or Inference Endpoints? below.<\/p>\n
\t\tClean up<\/p>\n
Jobs are billed per second, so stop the server when you’re done:
\nhf jobs cancel <\/p>\n
The –timeout you set is a safety net (it’ll auto-stop), but cancelling explicitly is cheaper. An a10g-large runs at $1.50\/hour \u2014 check hf jobs hardware for the full price list and pick the smallest flavor that fits your model.<\/p>\n
\t\tGoing further: bigger models<\/p>\n
The same command scales to much larger models \u2014 pick a beefier –flavor and tell vLLM to shard the model across the GPUs with –tensor-parallel-size. For example, the 122B Qwen3.5 mixture-of-experts model on 2\u00d7 H200:
\nhf jobs run –flavor h200x2 –expose 8000 –timeout 2h \\
\n vllm\/vllm-openai:latest \\
\n vllm serve Qwen\/Qwen3.5-122B-A10B \\
\n –host 0.0.0.0 –port 8000 –tensor-parallel-size 2 \\
\n –max-model-len 32768 –max-num-seqs 256<\/p>\n
–tensor-parallel-size should match the number of GPUs in the flavor (h200x2 \u2192 2, h200x8 \u2192 8). Run hf jobs hardware to see what’s available and give bigger models a longer –timeout, since they take longer to download and load. For large models, H200 flavors are usually the best value.
\nThe –max-model-len 32768 –max-num-seqs 256 flags are specific to this model: Qwen3.5-122B is a hybrid Mamba\/attention architecture with a 256K-token default context, which doesn’t leave enough memory for vLLM’s default batch settings. Capping the context length and concurrent-sequence count keeps it within the GPUs’ memory. If a model fails to start with an out-of-memory or cache-block error, dialing these two down is the first thing to try. Everything else (the exposed URL, the OpenAI client, the token auth) stays exactly the same.<\/p>\n
\t\tGoing further: Chat with it in a UI<\/p>\n
Prefer a chat window over curl? A few lines of Gradio point at the same endpoint. Add –reasoning-parser deepseek_r1 to the vllm serve command so Qwen3’s thinking comes back as a separate field (not necessary, but helpful), then run this code locally (you’ll just need the job ID):
\nimport gradio as gr
\nfrom gradio import ChatMessage
\nfrom huggingface_hub import get_token
\nfrom openai import OpenAI<\/p>\n
client = OpenAI(base_url=”https:\/\/–8000.hf.jobs\/v1″, api_key=get_token())<\/p>\n
def chat(message, history):
\n messages = ({“role”: m(“role”), “content”: m(“content”)} for m in history if not m.get(“metadata”))
\n messages.append({“role”: “user”, “content”: message})
\n stream = client.chat.completions.create(model=”Qwen\/Qwen3-4B”, messages=messages, stream=True)<\/p>\n
thinking, answer = “”, “”
\n for chunk in stream:
\n delta = chunk.choices(0).delta
\n thinking += delta.model_extra.get(“reasoning”, “”)
\n answer += delta.content or “”
\n out = ()
\n if thinking.strip():
\n status = “done” if answer.strip() else “pending”
\n out.append(ChatMessage(role=”assistant”, content=thinking, metadata={“title”: “\ud83d\udcad Thinking”, “status”: status}))
\n if answer.strip():
\n out.append(ChatMessage(role=”assistant”, content=answer))
\n yield out<\/p>\n
gr.ChatInterface(chat).launch()<\/p>\n
Run it, open http:\/\/127.0.0.1:7860, and chat \u2014 reasoning streams into the collapsible panel, the answer below.<\/p>\n
\t\tGoing further: SSH into the running server<\/p>\n
Need to debug a startup failure, watch GPU memory, or tail logs interactively? You can open a shell straight into the running job. Launch it with –ssh and make sure your public key is registered at huggingface.co\/settings\/keys:
\nhf jobs run –flavor a10g-large –expose 8000 –timeout 2h –ssh \\
\n vllm\/vllm-openai:latest \\
\n vllm serve Qwen\/Qwen3-4B –host 0.0.0.0 –port 8000<\/p>\n
then connect with the job ID:
\nhf jobs ssh <\/p>\n
You’re now inside the container, where you can run nvidia-smi, inspect the process, or poke at the model directly \u2014 which makes debugging and monitoring much easier than reading logs from the outside. SSH support requires huggingface_hub >= 1.20.0.<\/p>\n
\t\tGoing further: Use it as a coding-agent backend with Pi<\/p>\n
The same endpoint can back a terminal coding agent. Pi is a provider-agnostic agent harness. Point it at the job and you get a Read\/Write\/Edit\/Bash agent running on your own self-hosted model.
\nOne thing to set up first: agents drive the model through tool calls, and vLLM only accepts those if the server is launched with tool calling enabled. So relaunch with –enable-auto-tool-choice and a –tool-call-parser matching the model family (hermes for Qwen3). Agents also benefit from a stronger model, so this is a good place to bring in the bigger one:
\nhf jobs run –flavor h200x2 –expose 8000 –timeout 2h \\
\n vllm\/vllm-openai:latest \\
\n vllm serve Qwen\/Qwen3.5-122B-A10B \\
\n –host 0.0.0.0 –port 8000 –tensor-parallel-size 2 \\
\n –max-model-len 32768 –max-num-seqs 256 \\
\n –reasoning-parser deepseek_r1 \\
\n –enable-auto-tool-choice –tool-call-parser hermes<\/p>\n
Then add the job as a custom provider in ~\/.pi\/agent\/models.json:
\n{
\n “providers”: {
\n “hf-jobs”: {
\n “baseUrl”: “https:\/\/–8000.hf.jobs\/v1”,
\n “api”: “openai-completions”,
\n “apiKey”: “!hf auth token”,
\n “models”: (
\n { “id”: “Qwen\/Qwen3.5-122B-A10B” }
\n )
\n }
\n }
\n}<\/p>\n
Then launch the agent against it:
\npi<\/p>\n
The model you spun up a couple of commands ago, now driving an interactive coding agent in your terminal.<\/p>\n
\t\tHF Jobs or Inference Endpoints?<\/p>\n
HF Jobs isn’t the only way to serve a model on Hugging Face. Inference Endpoints are our managed product for the same job, and which one fits depends on what you’re after.
\nReach for HF Jobs when you want maximum flexibility and control: it’s just docker run on HF infrastructure, so you pick the image, the exact vllm serve flags, and the hardware, and you pay per second for as long as the job runs. That makes it a great fit for experiments, one-off evals, batch generation, or kicking the tires on a model before committing to anything.
\nReach for Inference Endpoints when you want something more production-ready. They add the operational niceties a long-lived service needs: finer-grained access control (an endpoint can be public, protected, or private), and scale-to-zero, so you’re not billed during periods of inactivity. If you’re standing up a durable endpoint rather than running a job, that’s the tool to grab.<\/p>\n
\t\tFurther reading<\/p>\n
This post sticks to vLLM, but the same expose-a-port pattern works with any OpenAI-compatible server. To serve GGUFs with llama.cpp or run SGLang instead, see the Serve Models on Jobs guide, which walks through those backends. You can spin up a private, OpenAI-compatible LLM endpoint on Hugging Face infrastructure with a single command \u2014 no servers to provision, no Kubernetes, pay-per-second. Once it’s up, you can query it from your laptop, a notebook, or anywhere else. It’s the quickest way to stand up a model for tests, evals, or batch generation. […]<\/p>\n","protected":false},"author":1,"featured_media":5331,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[676],"tags":[],"class_list":["post-6129","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-tech-ai"],"_links":{"self":[{"href":"https:\/\/daiilynews.cu.ma\/index.php?rest_route=\/wp\/v2\/posts\/6129","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/daiilynews.cu.ma\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/daiilynews.cu.ma\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/daiilynews.cu.ma\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/daiilynews.cu.ma\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=6129"}],"version-history":[{"count":0,"href":"https:\/\/daiilynews.cu.ma\/index.php?rest_route=\/wp\/v2\/posts\/6129\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/daiilynews.cu.ma\/index.php?rest_route=\/wp\/v2\/media\/5331"}],"wp:attachment":[{"href":"https:\/\/daiilynews.cu.ma\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=6129"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/daiilynews.cu.ma\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=6129"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/daiilynews.cu.ma\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=6129"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
\n
\n
Source link <\/a><\/p>\n","protected":false},"excerpt":{"rendered":"