{ "hf_id": "Qwen/Qwen3-1.7B", "meta": { "title": "Qwen3-1.7B", "slug": "qwen3-1.7b", "provider": "Qwen", "description": "Qwen3 1.7B dense model with hybrid thinking/non-thinking modes, validated for BF16 serving on Intel Xeon 6.", "date_added": "2026-08-14", "date_updated": "2026-09-12", "tasks": [ "text" ], "performance_headline": "Validated on Intel Xeon 6 (GNR) with BF16 serving", "related_recipes": [ "Qwen/Qwen3-4B" ], "hardware": { "xeon6": "verified" } }, "recommended_command": { "hardware": "xeon6", "strategy": "single_node_tp", "variant": "default", "node_count": 1, "deploy_type": "single_node", "env": {}, "docker_image": "vllm/vllm-openai-cpu:latest-x86_64", "command": "vllm serve Qwen/Qwen3-1.7B \\\n --tensor-parallel-size 1 \\\n --max-num-batched-tokens 16384 \\\n --gpu-memory-utilization 0.8 \\\n --enable-auto-tool-choice \\\n --tool-call-parser hermes \\\n --reasoning-parser qwen3", "argv": [ "vllm", "serve", "Qwen/Qwen3-1.7B", "--tensor-parallel-size", "1", "--max-num-batched-tokens", "16384", "--gpu-memory-utilization", "0.8", "--enable-auto-tool-choice", "--tool-call-parser", "hermes", "--reasoning-parser", "qwen3" ], "docker_command": "docker run --shm-size=16g \\\n --privileged --ipc=host -p 8000:8000 \\\n -v ~/.cache/huggingface:/root/.cache/huggingface \\\n vllm/vllm-openai-cpu:latest-x86_64 Qwen/Qwen3-1.7B \\\n --tensor-parallel-size 1 \\\n --max-num-batched-tokens 16384 \\\n --gpu-memory-utilization 0.8 \\\n --enable-auto-tool-choice \\\n --tool-call-parser hermes \\\n --reasoning-parser qwen3", "docker_argv": [ "docker", "run", "--shm-size", "16g", "--privileged", "--ipc=host", "-p", "8000:8000", "-v", "~/.cache/huggingface:/root/.cache/huggingface", "vllm/vllm-openai-cpu:latest-x86_64", "Qwen/Qwen3-1.7B", "--tensor-parallel-size", "1", "--max-num-batched-tokens", "16384", "--gpu-memory-utilization", "0.8", "--enable-auto-tool-choice", "--tool-call-parser", "hermes", "--reasoning-parser", "qwen3" ], "strategy_spec": { "name": "single_node_tp", "deploy_type": "single_node", "display_name": "Tensor Parallel", "short_label": "TP", "orientation": "latency", "description": "Single-node tensor parallel. Splits the model across all local GPUs. TP size is set to the GPU count at deploy time. The simplest multi-GPU strategy — works for all model architectures.\n", "hardware_match": { "min_gpus": 1, "max_gpus": 8, "multi_node": false }, "vllm_args": [], "parallel_flag": "--tensor-parallel-size" }, "hardware_profile": { "brand": "Intel", "generation": "cpu", "display_name": "Xeon 6", "description": "Intel Xeon 6 CPU NUMA node · x86 CPU backend", "gpu_count": 4, "vram_gb": 1024, "multi_node": false, "restricted": true }, "alternatives": { "multi_node_tp": "/Qwen/Qwen3-1.7B/strategies/multi_node_tp.json" }, "by_hardware": { "xeon6": "/Qwen/Qwen3-1.7B/hw/xeon6.json" } }, "model": { "model_id": "Qwen/Qwen3-1.7B", "min_vllm_version": "0.8.5", "architecture": "dense", "parameter_count": "1.7B", "active_parameters": "1.7B", "context_length": 40960, "base_args": [], "base_env": {}, "install": { "pip": { "command": "uv venv\nsource .venv/bin/activate\nuv pip install -U vllm --torch-backend auto" }, "docker": { "command": "docker pull vllm/vllm-openai:latest" } } }, "features": { "tool_calling": { "description": "Enable automatic tool choice with the Hermes parser", "args": [ "--enable-auto-tool-choice", "--tool-call-parser", "hermes" ] }, "reasoning": { "description": "Enable Qwen3 thinking mode with the Qwen3 reasoning parser", "args": [ "--reasoning-parser", "qwen3" ] } }, "opt_in_features": [], "variants": { "default": { "precision": "bf16", "vram_minimum_gb": 5, "description": "Full precision BF16", "supported_hardware": [ "xeon6" ] } }, "hardware_overrides": { "cpu": { "extra_args": [ "--max-num-batched-tokens", "16384", "--gpu-memory-utilization", "0.8" ] } }, "guide": "## Overview\n\nQwen3-1.7B is a compact dense Qwen3 model with hybrid thinking and non-thinking\nmodes. This recipe includes an Intel Xeon 6 CPU configuration validated with\nBF16 serving.\n\n## Prerequisites\n\n- Hardware: 1x Xeon 6 CPUs\n- vLLM >= 0.8.5\n\n### pip (Intel Xeon 6 CPUs)\n\nFor Intel and AMD x86 CPUs, follow the\n[CPU pre-built wheels](https://docs.vllm.ai/en/latest/getting_started/installation/cpu/#pre-built-wheels)\ninstallation instructions.\n\n### Docker (Intel Xeon 6 CPUs)\n\n```bash\ndocker pull vllm/vllm-openai-cpu:latest-x86_64\n```\n\n## Intel Xeon 6\n\nChoose the tensor parallel size based on the system topology and deployment\nrequirements. Add `--tensor-parallel-size ` when needed; the recipe does\nnot prescribe a Xeon 6 TP value or hard-code NUMA node IDs.\n\n```bash\nvllm serve Qwen/Qwen3-1.7B \\\n --max-num-batched-tokens 16384 \\\n --gpu-memory-utilization 0.8\n```\n\nDocker:\n\n```bash\ndocker run \\\n --privileged --ipc=host -p 8000:8000 \\\n -v ~/.cache/huggingface:/root/.cache/huggingface \\\n vllm/vllm-openai-cpu:latest-x86_64 Qwen/Qwen3-1.7B \\\n --tensor-parallel-size 1 \\\n --max-num-batched-tokens 16384 \\\n --gpu-memory-utilization 0.8 \\\n --enable-auto-tool-choice \\\n --tool-call-parser hermes \\\n --reasoning-parser qwen3\n```\n\n## Client Usage\n\n```python\nfrom openai import OpenAI\n\nclient = OpenAI(base_url=\"http://localhost:8000/v1\", api_key=\"unused\")\nresponse = client.chat.completions.create(\n model=\"Qwen/Qwen3-1.7B\",\n messages=[{\"role\": \"user\", \"content\": \"Explain tensor parallelism briefly.\"}],\n)\nprint(response.choices[0].message.content)\n```\n\n## References\n\n- [Model card](https://huggingface.co/Qwen/Qwen3-1.7B)\n- [vLLM CPU installation](https://docs.vllm.ai/en/latest/getting_started/installation/cpu/)\n", "source": { "source": "vllm", "repo": "vllm-project/vllm", "ref": "main", "sha": "389ffebe555705c85337025d5df108d0384d365e", "path": "recipes/models/Qwen/Qwen3-1.7B.yaml", "edit_url": "https://github.com/vllm-project/vllm/edit/main/recipes/models/Qwen/Qwen3-1.7B.yaml", "overlays": [] } }