LLMs ·

Hunyuan Hy3 (295B-A21B)

Parameters
299B (21.0B active)
Architecture
Mixture of experts
Max context
256K tokens
License
apache-2.0
Released
2026-07

How to run it

Quantized files · GGUF

Works in LM Studio, llama.cpp, Jan and Ollama. No sign-in needed.

huggingface.co/bartowski/Hy3-GGUF (opens in a new tab)

ollama run hf.co/bartowski/Hy3-GGUF

Original weights · Hugging Face

Full-precision files from Tencent, for fine-tuning, vLLM, Transformers.

huggingface.co/tencent/Hy3 (opens in a new tab)

No sign-in needed.

Official repo · GitHub

Reference code, inference scripts and docs from Tencent. The weights themselves download from Hugging Face.

github.com/Tencent-Hunyuan/Hy3 (opens in a new tab)

git clone https://github.com/Tencent-Hunyuan/Hy3

Apps that run Hunyuan Hy3 (295B-A21B)

Our pick for each kind of computer, assuming the model fits in its memory. Pick your own GPU or device in the Model Finder for an exact answer.

Mac (Apple silicon)

LM Studio

Point-and-click: search, download and chat in one window.

Also good:

Windows PC, NVIDIA GPU

LM Studio

Point-and-click: search, download and chat in one window.

Also good:

Windows PC, AMD Radeon

Lemonade

AMD’s own app: llama.cpp tuned for Radeon on Vulkan and ROCm.

Also good:

Linux, NVIDIA GPU

LM Studio

Point-and-click: search, download and chat in one window.

Also good:

Linux server, 80 GB+ GPUs

vLLM

The full model fits in GPU memory at 8-bit, so it can batch many requests: best for serving a team or an app.

Also good:

App Type Opens it as Systems Engine Start
LM Studio Desktop app GGUF macOSWindowsLinux llama.cpp, MLX Open in LM Studio
Ollama CLI + API GGUF from Hugging Face macOSWindowsLinux llama.cpp, MLX
ollama run hf.co/bartowski/Hy3-GGUF:Q4_K_M
llama.cpp CLI + API GGUF macOSWindowsLinux llama.cpp
llama-server -hf bartowski/Hy3-GGUF:Q4_K_M
Jan Desktop app GGUF macOSWindowsLinux llama.cpp, MLX Open in Jan
vLLM Server Original weights WSLWindowsLinux vLLM
vllm serve tencent/Hy3
SGLang Server Original weights WSLWindowsLinux SGLang
python3 -m sglang.launch_server --model-path tencent/Hy3
Docker Model Runner CLI + API GGUF macOSWindowsLinux llama.cpp, vLLM
docker model run hf.co/bartowski/Hy3-GGUF:Q4_K_M
Lemonade Desktop app GGUF macOSWindowsLinux llama.cpp, ONNX Runtime GenAI
lemonade pull bartowski/Hy3-GGUF:Q4_K_M
Unsloth Desktop Desktop app GGUF macOSWindowsLinux llama.cpp, MLX, stable-diffusion.cpp Open in Unsloth Desktop
Atomic Chat Desktop app GGUF macOSWindowsLinux llama.cpp, MLX-VLM Open in Atomic Chat
Pi Coding agent GGUF macOSWindowsLinux uses llama.cpp or MLX LM Point it at a llama.cpp or MLX LM server
Hermes Agent Assistant GGUF macOSWSLWindowsLinux uses llama.cpp or MLX LM Point it at a llama.cpp or MLX LM server
OpenClaw Assistant GGUF macOSWSLWindowsLinux uses llama.cpp or MLX LM Point it at a llama.cpp or MLX LM server
OpenCode Coding agent GGUF macOSWindowsLinux uses llama.cpp, Ollama or LM Studio Point it at a llama.cpp or MLX LM server
Codex CLI Coding agent GGUF macOSWSLWindowsLinux uses Ollama or any OpenAI-compatible server Point it at a llama.cpp or MLX LM server
OpenHands Coding agent GGUF macOSWSLWindowsLinux uses llama.cpp, Ollama or LM Studio Point it at a llama.cpp or MLX LM server
Zed Coding agent GGUF macOSWindowsLinux uses llama.cpp, Ollama or LM Studio Point it at a llama.cpp or MLX LM server
Cline Coding agent GGUF macOSWindowsLinux uses llama.cpp, Ollama or LM Studio Point it at a llama.cpp or MLX LM server
Open Interpreter Coding agent GGUF macOSWindowsLinux uses llama.cpp, Ollama or LM Studio Point it at a llama.cpp or MLX LM server
Goose Coding agent GGUF macOSWindowsLinux uses llama.cpp, Ollama or LM Studio Point it at a llama.cpp or MLX LM server
Aider Coding agent GGUF macOSWindowsLinux uses llama.cpp, Ollama or LM Studio Point it at a llama.cpp or MLX LM server
Crush Coding agent GGUF macOSWindowsLinux uses llama.cpp, Ollama or LM Studio Point it at a llama.cpp or MLX LM server
Qwen Code Coding agent GGUF macOSWindowsLinux uses llama.cpp, Ollama or LM Studio Point it at a llama.cpp or MLX LM server
Kilo Code Coding agent GGUF macOSWindowsLinux uses llama.cpp, Ollama or LM Studio Point it at a llama.cpp or MLX LM server
Open WebUI Assistant GGUF macOSWindowsLinux uses llama.cpp, Ollama or LM Studio Point it at a llama.cpp or MLX LM server
Khoj Assistant GGUF macOSWindowsLinux uses llama.cpp, Ollama or LM Studio Point it at a llama.cpp or MLX LM server
Letta Assistant GGUF macOSWindowsLinux uses llama.cpp, Ollama or LM Studio Point it at a llama.cpp or MLX LM server
KoboldCpp Desktop app GGUF macOSWindowsLinux llama.cpp Get KoboldCpp
Text Generation WebUI Desktop app GGUF macOSWindowsLinux llama.cpp, Transformers, ExLlamaV3 Get Text Generation WebUI
llamafile CLI + API GGUF macOSWindowsLinux llama.cpp Get llamafile
Msty Studio Desktop app GGUF macOSWindowsLinux Ollama, llama.cpp, MLX Open in Msty Studio
Llama (macOS) Desktop app GGUF macOS llama.cpp Open in Llama (macOS)
RecurseChat Desktop app GGUF macOS llama.cpp Open in RecurseChat
node-llama-cpp Library GGUF macOSWindowsLinux llama.cpp Get node-llama-cpp
Continue Coding agent GGUF macOSWindowsLinux uses Ollama, LM Studio or llama.cpp Point it at a llama.cpp or MLX LM server
SillyTavern Assistant GGUF macOSWindowsLinux uses Ollama, LM Studio or llama.cpp Point it at a llama.cpp or MLX LM server
LibreChat Assistant GGUF macOSWindowsLinux uses Ollama, LM Studio or llama.cpp Point it at a llama.cpp or MLX LM server
Cherry Studio Assistant GGUF macOSWindowsLinux uses Ollama, LM Studio or llama.cpp Point it at a llama.cpp or MLX LM server
Chatbox Assistant GGUF macOSWindowsLinux uses Ollama, LM Studio or llama.cpp Point it at a llama.cpp or MLX LM server
PrivateGPT Assistant GGUF macOSWindowsLinux uses Ollama, LM Studio or llama.cpp Point it at a llama.cpp or MLX LM server
PocketPal AI Mobile app GGUF iOSAndroid llama.cpp App Store Google Play
ChatterUI Mobile app GGUF Android llama.cpp Download the APK
LLM Farm Mobile app GGUF iOS llama.cpp Not on the App Store or TestFlight for now (checked 2026-11-09).

Which apps can open a model depends on the files published for it: GGUF for llama.cpp-based apps, MLX for Apple’s engine, the original weights for vLLM and SGLang. Compare every app.

Memory needed

Weights plus KV cache and runtime overhead. Leave a little extra free for the operating system and other apps. Try another context length.

Quantization Quality Weights Total at 8K context Total at 32K context Download
Q2_K Low 120 GB 123 GB 131 GB GGUF · folder (opens in a new tab)
Q3_K_M Low 146 GB 150 GB 158 GB GGUF · folder (opens in a new tab)
Q4_K_M Good 182 GB 186 GB 194 GB GGUF · folder (opens in a new tab)
Q5_K_M High 212 GB 215 GB 223 GB GGUF · folder (opens in a new tab)
Q6_K High 245 GB 248 GB 256 GB GGUF · folder (opens in a new tab)
Q8_0 Very high 317 GB 320 GB 328 GB GGUF · folder (opens in a new tab)
F16 Full 598 GB 601 GB 609 GB Original weights (opens in a new tab)

Best hardware for Hunyuan Hy3 (295B-A21B)

Quality Hardware Quant Memory Speed Runs
89Excellent quality (A+) · 89 of 100: how capable the model is at Q4_K_M, whatever it runs on. Match score 92/100 (quality, fit, speed and memory use) sets the ranking. Apple Mac Studio (2025) (M4 Max or M3 Ultra)Apple M3 Ultra (512 GB) Q4_K_M 216 GB / 384 GB 36.2 tok/s Runs great
79Great quality (A) · 79 of 100: how capable the model is at Q3_K_M, whatever it runs on. Match score 89/100 (quality, fit, speed and memory use) sets the ranking. Apple Mac Studio (2025) (M4 Max or M3 Ultra)Apple M3 Ultra (256 GB) Q3_K_M 165 GB / 192 GB 45.4 tok/s Runs welltight fit
66Good quality (B) · 66 of 100: how capable the model is at Q2_K, whatever it runs on. Match score 83/100 (quality, fit, speed and memory use) sets the ranking. Apple Mac Studio (2023) (M2 Max or M2 Ultra)Apple M2 Ultra (192 GB) Q2_K 134 GB / 144 GB 54.8 tok/s Runs welltight fit
93Excellent quality (A+) · 93 of 100: how capable the model is at Q6_K, whatever it runs on. Match score 96/100 (quality, fit, speed and memory use) sets the ranking. Apple Mac Studio (M5 Max or M5 Ultra)Apple M5 Ultra (512 GB) Q6_K 279 GB / 384 GB 36.4 tok/s Runs great
91Excellent quality (A+) · 91 of 100: how capable the model is at Q5_K_M, whatever it runs on. Match score 96/100 (quality, fit, speed and memory use) sets the ranking. AMD Instinct MI350XAMD Instinct MI350X Q5_K_M 230 GB / 288 GB 154 tok/s Runs great
89Excellent quality (A+) · 89 of 100: how capable the model is at Q4_K_M, whatever it runs on. Match score 95/100 (quality, fit, speed and memory use) sets the ranking. AMD Instinct MI325XAMD Instinct MI325X Q4_K_M 198 GB / 256 GB 150 tok/s Runs great
89Excellent quality (A+) · 89 of 100: how capable the model is at Q4_K_M, whatever it runs on. Match score 95/100 (quality, fit, speed and memory use) sets the ranking. Dell Pro Max with GB300NVIDIA GB300 Grace Blackwell Ultra Desktop Superchip Q4_K_M 198 GB / 252 GB 173 tok/s Runs great
79Great quality (A) · 79 of 100: how capable the model is at Q3_K_M, whatever it runs on. Match score 90/100 (quality, fit, speed and memory use) sets the ranking. AMD Instinct MI300XAMD Instinct MI300X Q3_K_M 159 GB / 192 GB 163 tok/s Runs great
79Great quality (A) · 79 of 100: how capable the model is at Q3_K_M, whatever it runs on. Match score 89/100 (quality, fit, speed and memory use) sets the ranking. Apple Mac Studio (M5 Max or M5 Ultra)Apple M5 Ultra (256 GB) Q3_K_M 165 GB / 192 GB 62.3 tok/s Runs welltight fit
79Great quality (A) · 79 of 100: how capable the model is at Q3_K_M, whatever it runs on. Match score 89/100 (quality, fit, speed and memory use) sets the ranking. NVIDIA B200NVIDIA B200 Q3_K_M 159 GB / 180 GB 204 tok/s Runs welltight fit

Check it on your own hardware

Run it on a cluster

Devices that can’t run Hunyuan Hy3 (295B-A21B) alone can run it together. These example clusters do:

Try it with your own devices

Estimates come from published hardware specs and our open formulas, not from running the model on your machine. Real speed varies with runtime, drivers and settings. Numbers marked “Measured” come from a linked benchmark.

Was this page helpful?