{
  "hf_id": "meta-llama/Llama-3.2-1B-Instruct",
  "meta": {
    "title": "Llama-3.2-1B-Instruct",
    "slug": "llama-3.2-1b-instruct",
    "provider": "Meta",
    "description": "Meta Llama 3.2 1B Instruct with CPU-validated Red Hat AI W8A8 and AMead10 AWQ variants.",
    "date_added": "2026-08-18",
    "date_updated": "2026-09-12",
    "tasks": [
      "text"
    ],
    "performance_headline": "W8A8 and AWQ variants validated on Intel Xeon 6",
    "related_recipes": [
      "meta-llama/Llama-3.2-1B",
      "meta-llama/Llama-3.2-3B-Instruct"
    ],
    "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 meta-llama/Llama-3.2-1B-Instruct \\\n  --tensor-parallel-size 1",
    "argv": [
      "vllm",
      "serve",
      "meta-llama/Llama-3.2-1B-Instruct",
      "--tensor-parallel-size",
      "1"
    ],
    "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 meta-llama/Llama-3.2-1B-Instruct \\\n  --tensor-parallel-size 1",
    "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",
      "meta-llama/Llama-3.2-1B-Instruct",
      "--tensor-parallel-size",
      "1"
    ],
    "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": "/meta-llama/Llama-3.2-1B-Instruct/strategies/multi_node_tp.json"
    },
    "by_hardware": {
      "xeon6": "/meta-llama/Llama-3.2-1B-Instruct/hw/xeon6.json"
    }
  },
  "model": {
    "model_id": "meta-llama/Llama-3.2-1B-Instruct",
    "min_vllm_version": "0.6.2",
    "architecture": "dense",
    "parameter_count": "1.23B",
    "active_parameters": "1.23B",
    "context_length": 131072,
    "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": {},
  "opt_in_features": [],
  "variants": {
    "default": {
      "precision": "bf16",
      "vram_minimum_gb": 3,
      "description": "Full precision BF16 parent checkpoint",
      "supported_hardware": [
        "xeon6"
      ]
    },
    "w8a8_int8": {
      "model_id": "RedHatAI/Llama-3.2-1B-Instruct-quantized.w8a8",
      "precision": "int8",
      "vram_minimum_gb": 2,
      "description": "Red Hat AI INT8 W8A8 compressed-tensors checkpoint",
      "supported_hardware": [
        "xeon6"
      ],
      "json": "/RedHatAI/Llama-3.2-1B-Instruct-quantized.w8a8.json"
    },
    "awq_int4": {
      "model_id": "AMead10/Llama-3.2-1B-Instruct-AWQ",
      "precision": "int4",
      "vram_minimum_gb": 2,
      "description": "AWQ INT4 checkpoint",
      "supported_hardware": [
        "xeon6"
      ],
      "extra_args": [
        "--quantization",
        "awq"
      ],
      "json": "/AMead10/Llama-3.2-1B-Instruct-AWQ.json"
    }
  },
  "hardware_overrides": {},
  "guide": "## Overview\n\nThis recipe groups the Llama 3.2 1B Instruct family under the canonical Meta\nparent. The Xeon 6 validation workbook has PASS rows for the Red Hat AI W8A8\nand AMead10 AWQ variants.\n\nThe W8A8 checkpoint is detected from compressed-tensors metadata. The AWQ\nvariant uses the recipe's `--quantization awq` selector.\n\n## Prerequisites\n\n- Hardware: 1x Xeon6/Xeon5 NUMA node\n- vLLM >= 0.6.2\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\n```bash\nvllm serve meta-llama/Llama-3.2-1B-Instruct \\\n  --tensor-parallel-size 1\n```\n\nDocker (the image entrypoint is `vllm serve`):\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 meta-llama/Llama-3.2-1B-Instruct \\\n  --tensor-parallel-size 1\n```\n\nThe example uses TP=1. Adjust TP/DP for the deployment topology;\nhost-specific CPU binding is intentionally not hard-coded.\n\n## Runtime and Platform Tuning\n\nThe following validation settings are not model requirements and are intentionally\nnot portable CPU recipe defaults:\n\n- `--max-num-batched-tokens` and `--max-num-seqs`: scheduler batch/concurrency\n  tuning for workload shape, latency targets, and platform capacity.\n- `--gpu-memory-utilization`: platform memory-budget tuning.\n- `--no-enable-prefix-caching`: workload/benchmark cache-policy tuning.\n- `VLLM_ENGINE_ITERATION_TIMEOUT_S`: runtime operational timeout tuning.\n\nHardware-specific overrides may still use these settings when they are part of a\nvalidated platform configuration.\n\n## References\n\n- [Meta parent model](https://huggingface.co/meta-llama/Llama-3.2-1B-Instruct)\n- [Red Hat AI W8A8 checkpoint](https://huggingface.co/RedHatAI/Llama-3.2-1B-Instruct-quantized.w8a8)\n- [AMead10 AWQ checkpoint](https://huggingface.co/AMead10/Llama-3.2-1B-Instruct-AWQ)\n",
  "source": {
    "source": "vllm",
    "repo": "vllm-project/vllm",
    "ref": "main",
    "sha": "389ffebe555705c85337025d5df108d0384d365e",
    "path": "recipes/models/meta-llama/Llama-3.2-1B-Instruct.yaml",
    "edit_url": "https://github.com/vllm-project/vllm/edit/main/recipes/models/meta-llama/Llama-3.2-1B-Instruct.yaml",
    "overlays": []
  }
}