How to Deploy Hy3 Locally
Hy3 is a 295B MoE that Tencent Hunyuan open-sourced in July 2026, using 21B parameters per token under the Apache 2.0 license. At 4-bit with 8K it takes about 186 GB, too much for any single GPU or 128GB machine; a 128GB machine can only run 2-bit, at about 20 tokens/s. Its context is heavy on VRAM: the full 256K takes about 269 GB, over 80 GB more than at 8K.
Hy3 details
- Min VRAM at 4-bit186 GB · 8K
- Parameters295B
- Active params21B
- Max context256K
- Architecture
- MoE
- Experts offloaded
- 11 GB VRAM + 177 GB RAM
- License
- Apache-2.0
- Launch date
- Jul 6, 2026
- Vendor
- Tencent
- Hugging Face repo
- tencent/Hy3
- GGUF repo
- bartowski/Hy3-GGUF
- NVFP4 repo (Blackwell)
- RedHatAI/Hy3-NVFP4-FP8
- Layers
- 80
- Hidden size
- 4,096
- KV heads
- 8
- Head dim
- 128
How much VRAM does Hy3 need for local deployment?
| Quantization | WeightsGB | 8K contextGB | 32K contextGB | 128K contextGB | 256K context (max)GB |
|---|---|---|---|---|---|
| 1-bit | 71.1GGUF | 74.9 | 82.9 | 115.1 | 158.1 |
| 2-bit | 107.2GGUF | 111 | 119 | 151.2 | 194.2 |
| 3-bit | 143.1GGUF | 146.9 | 154.9 | 187.1 | 230.1 |
| 4-bit | 182.2GGUF | 186 | 194 | 226.2 | 269.2 |
| 5-bit | 212.8GGUF | 216.6 | 224.6 | 256.8 | 299.8 |
| 8-bit | 317.7GGUF | 321.5 | 329.5 | 361.7 | 404.7 |
| BF16/FP16 | 619.5est. | 623.3 | 631.3 | 663.5 | 706.5 |
Full calculation rules are on the Methodology page.
Can a single GPU run Hy3?
Not on any single graphics card; on one machine, you need a lot of unified memory. 4-bit with 8K of context is about 186 GB, far beyond any one GPU. The only standalone machine that holds 4-bit is the 512GB Mac Studio M3 Ultra, at about 36 tokens/s, and it has room for 8-bit as well. 128GB machines such as the DGX Spark and Ryzen AI Max+ 395 have to drop to 2-bit, at about 20 tokens/s, with context capped near 86K, because this model's context is unusually memory-hungry and every step up in window size takes noticeably more space. If all you have is one GPU, put the experts in a big-RAM server instead.
| Device | Price | Speed t/s | Max context |
|---|---|---|---|
| Ryzen AI Max+ 395 128GBWhole system · 128 GB | $4,46420 listings | 19.9 | 86K |
| MacBook Pro M5 Max 128GBWhole system · 128 GB | $7,29921 listings | 42.2 | 86K |
| $8,34326 listings | 21.1 | 86K | |
| Mac Studio M3 Ultra 512GBWhole system · 512 GB | $21,95015 listings | 52.8 | 256K |
| Device | Price | Speed t/s | Max context |
|---|---|---|---|
| Mac Studio M3 Ultra 512GBWhole system · 512 GB | $21,95015 listings | 36.4 | 256K |
| Device | Price | Speed t/s | Max context |
|---|---|---|---|
| Mac Studio M3 Ultra 512GBWhole system · 512 GB | $21,95015 listings | 23.4 | 256K |
Only common GPUs and systems are listed, one set for models under 50B and another for larger ones, sorted by price from low to high.
How many GPUs do you need to run Hy3?
Four 96GB RTX PRO 6000s are the smallest 4-bit setup, at about 56 tokens/s. With 32K of context, 4-bit needs about 194 GB, and eight 24GB cards can't cover that once each keeps a 10% reserve, so RTX 3090s and 4090s are limited to 2-bit, where eight of them do about 44 tokens/s. The 32GB RTX 5090 also needs eight cards for 4-bit and lands at roughly the same speed as four RTX PRO 6000s. Tencent's official vLLM and SGLang recipes are both written for eight GPUs.
| Device | Cards | Total price | Total VRAM | Speed t/s | Total power |
|---|---|---|---|---|---|
| 4 cards | $3,580 | 128 GB | 42.8 | 1,000 W | |
| 4 cards | $6,584 | 128 GB | 30.9 | 920 W | |
| Radeon RX 7900 XTX24 GB per card | 8 cards | $10,000 | 192 GB | 45 | 2,840 W |
| Instinct MI21064 GB per card | 2 cards | $10,082 | 128 GB | 66.9 | 600 W |
| 8 cards | $14,184 | 192 GB | 44.1 | 2,800 W | |
| 4 cards | $19,596 | 192 GB | 37.6 | 1,200 W | |
| 2 cards | $21,444 | 144 GB | 58.1 | 600 W | |
| 8 cards | $31,200 | 192 GB | 46.8 | 3,600 W | |
| 4 cards | $32,000 | 128 GB | 71 | 2,300 W | |
| 2 cards | $40,798 | 160 GB | 74.7 | 600 W | |
| 2 cards | $44,700 | 192 GB | 71 | 1,200 W | |
| 4 cards | No price | 192 GB | 46.8 | 1,800 W |
| Device | Cards | Total price | Total VRAM | Speed t/s | Total power |
|---|---|---|---|---|---|
| 8 cards | $7,160 | 256 GB | 32.1 | 2,000 W | |
| 8 cards | $13,168 | 256 GB | 22.8 | 1,840 W | |
| 2 units | $16,686 | 256 GB | 10.9 | 480 W | |
| Instinct MI21064 GB per card | 4 cards | $20,164 | 256 GB | 52.1 | 1,200 W |
| 8 cards | $39,192 | 384 GB | 28 | 2,400 W | |
| 4 cards | $42,888 | 288 GB | 44.7 | 1,200 W | |
| 8 cards | $64,000 | 256 GB | 55.7 | 4,600 W | |
| 4 cards | $81,596 | 320 GB | 58.9 | 1,200 W | |
| 4 cards | $89,400 | 384 GB | 55.7 | 2,400 W | |
| 8 cards | No price | 384 GB | 35.4 | 3,600 W |
| Device | Cards | Total price | Total VRAM | Speed t/s | Total power |
|---|---|---|---|---|---|
| 4 units | $33,372 | 512 GB | 7.3 | 960 W | |
| 8 cards | $39,192 | 384 GB | 19.2 | 2,400 W | |
| Instinct MI21064 GB per card | 8 cards | $40,328 | 512 GB | 37.2 | 2,400 W |
| 8 cards | $85,776 | 576 GB | 31.5 | 2,400 W | |
| 4 cards | $89,400 | 384 GB | 40 | 2,400 W | |
| 8 cards | $163,192 | 640 GB | 42.6 | 2,400 W | |
| 8 cards | No price | 384 GB | 24.5 | 3,600 W |
Full calculation rules are on the Methodology page.
What PC or server build do you need to run Hy3 locally?
With the experts in system RAM, each token has to read a fair amount of data from memory (most of the 21B active parameters are experts), so speed is held back mainly by memory bandwidth. At 4-bit, a used 8-channel DDR4 server with one RTX 3090 does about 14 tokens/s, and a 12-channel DDR5 server with an RTX PRO 6000 about 46. An ordinary dual-channel desktop can't hold 4-bit even with every slot filled, so it can only run 2-bit: about 15 tokens/s on DDR5 and about 9 on DDR4.
Tesla V100 32GB + Dual Xeon E5 DDR4
BudgetGeForce RTX 3090 + Dual EPYC DDR4
Best valueGeForce RTX 5090 + Single EPYC DDR5
FlagshipTesla V100 32GB + Dual Xeon E5 DDR4
BudgetGeForce RTX 3090 + Dual EPYC DDR4
Best valueGeForce RTX 5090 + Single EPYC DDR5
Flagship8 × Tesla V100 32GB + Dual Xeon E5 8-GPU server
Budget- PSU
- Built-in 4 × 1,600 W
- Included
GeForce RTX 3090 + Dual EPYC DDR4
Best valueGeForce RTX 5090 + Dual EPYC DDR5
Flagship2 × RTX PRO 6000 + Dual EPYC DDR5
Giant modelsDetailed calculation rules are on the Methodology page.
As an eBay Partner, VRAMGlass may be compensated if you buy through the eBay links on this page. The price you pay stays the same.
What to know before running Hy3 locally
GGUFs and server versions
bartowski has made a full set of GGUFs from 1-bit to 8-bit; the 4-bit weights are about 182 GB and 2-bit about 107 GB. For servers, besides the official BF16 and FP8 versions, the vLLM recipe also lists an NVFP4 version from Red Hat that fits on four 80GB H100s.
Which framework to use
bartowski's GGUFs were quantized with llama.cpp release b9993, so mainline llama.cpp runs them; Ollama's official library doesn't have it. For servers, Tencent recommends vLLM (the recipe requires 0.28.0 or later) or SGLang; in vLLM, both the tool-call parser and the reasoning parser are called
hy_v3.Thinking toggle and sampling parameters
By default it doesn't think (
reasoning_effortisno_think); for complex tasks like math and code, switch it to high, and there's also a low level in between. Tencent recommendstemperature0.9 andtop_p1.0.Long context takes a lot of VRAM
It uses standard attention, so the context cache grows linearly with length: at 4-bit, 256K takes about 83 GB more than 8K (about 269 vs. 186 GB). Factor that in when sizing hardware, and if you don't need long context, don't max it out.
The license is now Apache 2.0
Tencent's earlier Hunyuan models (such as Hunyuan-A13B) used its own community license, which explicitly did not apply in the EU, the UK and South Korea; Hy3 switched to Apache 2.0, with no such regional restriction.
Launch commands
llama.cpp
- NVIDIA
- AMD
- Mac
- CPU
llama-server -hf bartowski/Hy3-GGUF:Q4_K_M --jinja -c 8192
vLLM
- Linux
- NVIDIA
Follow the deployment guide to prepare the required runtime and hardware.
# Switch to trtllm backend to work-around mnnvl workspace size issue. export VLLM_FLASHINFER_ALLREDUCE_BACKEND=trtllm vllm serve tencent/Hy3 \ --tensor-parallel-size 8 \ --speculative-config.method mtp \ --speculative-config.num_speculative_tokens 2 \ --tool-call-parser hy_v3 \ --reasoning-parser hy_v3 \ --enable-auto-tool-choice \ --port 8000 \ --served-model-name hy3
Ollama
- Windows
- macOS
- Linux
The Ollama library has no official tag for it yet.
File names follow that week's model-library snapshot; the definitions are in the methodology. Methodology
Other models in the Hunyuan family
| Model | Total params | Active params | 4-bit size |
|---|---|---|---|
| 770B | 49B | 467.3 GB |