Hy3
MoEToolsThinkingPopularTencent · 295B (21B active) · Mixture of Experts
Production-focused agentic MoE with strong coding, tool use and long-context reasoning
0
0
2026-07
256K tokens
Use cases
Your hardware
16 GB Reference Desktop
Quantization options
What is quantization?| Quant | Bits | VRAM | Disk | Quality | Status |
|---|---|---|---|---|---|
| Q2_K | 2 | 94.9 GB | 90.1 GB | low | Too heavy · ~1 t/s |
| Q3_K_M | 3 | 132.7 GB | 126.2 GB | moderate | Too heavy · ~1 t/s |
| Q4_K_M | 4 | 151.6 GB | 144.2 GB | good | Too heavy · ~1 t/s |
| Q5_K_M | 5 | 189.4 GB | 180.3 GB | good | Too heavy · ~1 t/s |
| Q6_K | 6 | 227.2 GB | 216.4 GB | excellent | Too heavy · ~1 t/s |
| Q8_0 | 8 | 302.7 GB | 288.5 GB | excellent | Too heavy · ~1 t/s |
| F16 | 16 | 604.9 GB | 577 GB | lossless | Too heavy · ~1 t/s |
About this model
Hy3 (hy3) is a 295B sparse mixture-of-experts (MoE) model activating 21B active per token from Tencent in the Hunyuan family, designed primarily for chat, reasoning, code workflows. Native reasoning/thinking tokens expand output length per query, so reserve extra KV cache headroom. Supports structured tool calling; use Q4_K_M or higher when strict JSON schema adherence matters. Supports up to 256K context tokens; start at 4K–8K with Q8_0 KV cache on tight GPUs.
Hardware planning baselines start at 164.8 GB minimum memory and 274.7 GB recommended memory. At Q4_K_M, weights plus baseline runtime overhead use roughly 151.6 GB of RAM/VRAM and 144.2 GB of disk space. At 295B, Hy3 belongs firmly in the workstation and multi-GPU tier. Running it comfortably requires 274.7 GB of total memory across dual RTX GPUs, high-memory Apple Silicon (Mac Studio Ultra/Max), or MoE hybrid CPU-RAM offloading—mobile devices and standard 16 GB laptops are too constrained for practical speeds.
Deploy Hy3 locally via llama.cpp with Flash Attention enabled. Under Apache License 2.0, review official weight cards before commercial redistribution.
Highlights
- Local Fit Baseline164.8 GB minimum and 274.7 GB recommended RAM/VRAM.
- Primary QuantQ4_K_M targets 151.6 GB memory and 144.2 GB disk.
- Context & Capabilities256K max context · Sparse MoE · Tool calling · Reasoning.
System requirements by device
Memory planning targets 164.8 GB minimum RAM/VRAM and 274.7 GB recommended memory. The baseline quant is Q4_K_M, estimated at 151.6 GB memory and 144.2 GB disk. Actual runtime usage shifts with context length, KV cache precision, and OS background overhead.
| Device | Notes |
|---|---|
| Mac (Apple silicon) | Requires a 48 GB–192 GB Mac Studio or MacBook Pro Max/Ultra with enough unified wired budget for 151.6 GB. |
| Windows / Linux GPU | Use dual/multi-GPU CUDA splitting (--tensor-split) or MoE CPU expert offloading (-ot) paired with 32–128 GB DDR5 system RAM. |
| Phones & Compact Edge Boards | Not practical on phones (164.8 GB min RAM exceeds Android LMK and iOS Jetsam limits). Pick a 2B–4B model on mobile. |
Start with a short session and leave memory for the operating system. A file fitting on disk does not guarantee that it will load in memory.
Estimated memory by quantization
These are rough estimates, not tested minimum requirements. Check the actual file and runtime documentation; context, offloading and operating-system overhead can change the memory needed.
| Quant Tier | Estimated memory | Disk Size | Quality |
|---|---|---|---|
| Q2_K | 94.9 GB | 90.1 GB | low |
| Q3_K_M | 132.7 GB | 126.2 GB | moderate |
| Q4_K_M | 151.6 GB | 144.2 GB | good |
| Q5_K_M | 189.4 GB | 180.3 GB | good |
| Q6_K | 227.2 GB | 216.4 GB | excellent |
| Q8_0 | 302.7 GB | 288.5 GB | excellent |
| F16 | 604.9 GB | 577.0 GB | lossless |
How to run Hy3 on your device
Start with a short prompt and the smallest quant that still gives the quality you need. A clean first run is more useful than loading a larger file with no memory headroom.
Run Hy3 on Multi-GPU or High-RAM Desktop
- Plan for 164.8 GB minimum combined memory and 274.7 GB recommended memory for Q4_K_M.
- Use llama.cpp `-ot ".ffn_.*_exps.=CPU"` or `--tensor-split` across multiple GPUs so attention and KV cache remain in fast VRAM.
- Enable Flash Attention (`-fa on`) and Q8_0 KV cache (`-ctk q8_0 -ctv q8_0`) to prevent context buffers from exceeding GPU headroom.
- Avoid attempting to run workstation-scale weights on smartphones or 8 GB laptops; use a 2B–8B checkpoint on portable devices.
Run Hy3 on High-Memory Apple Silicon Mac
- Verify you are on a 48 GB–192 GB Mac Studio or MacBook Pro Max/Ultra capable of holding 151.6 GB in wired unified memory.
- Launch via `llama-server` or LM Studio with MLX/Metal enabled and set initial context conservatively to 4K–8K.
- Monitor Activity Monitor Memory Pressure to confirm zero SSD swap thrashing during token generation.
- Step down to a lighter quantization (e.g., Q3_K_M or IQ4_XS) if total memory utilization exceeds 75%.
Hy3 vs alternatives
| Model | Params | Context | Min RAM | License |
|---|---|---|---|---|
| Hy3 | 295B (21B active) | 256K | 164.8 GB | Apache 2.0 |
| HunyuanImage 3.0 | 80B (13B active) | 4K | 44.7 GB | Tencent Hunyuan Community |
| HunyuanImage 3.0 Instruct | 80B (13B active) | 4K | 44.7 GB | Tencent Hunyuan Community |
| HunyuanVideo 1.5 | 8.3B | 4K | 4.6 GB | Tencent Hunyuan Community |
| Qwen 3 235B-A22B | 235B (22B active) | 128K | 131.3 GB | Apache 2.0 |
| Qwen 3 VL 235B-A22B | 235B (22B active) | 256K | 131.3 GB | Apache 2.0 |
Use this table to choose the smallest nearby model that still matches the job. A related model with lower RAM can be the better local choice when the current page fits only at the edge of available memory.
Frequently asked questions
- What is Hy3?
- Hy3 is a 295B sparse mixture-of-experts model (21B active active per token) from Tencent, supporting up to 256K tokens with 164.8 GB minimum RAM and 274.7 GB recommended RAM.
- How do I download and install hy3?
- Download a GGUF build for Hy3, start with Q4_K_M, and confirm the model fits locally before increasing context or quant quality.
- How much VRAM or RAM does Hy3 require?
- At Q4_K_M, Hy3 occupies roughly 151.6 GB of active memory and 144.2 GB on disk. Add 2–6 GB of spare headroom for KV cache buffers, runtime scratch space, and OS apps (274.7 GB recommended).
- What is the best way to run Hy3 locally?
- Run Hy3 in llama.cpp starting with Q4_K_M. Keep initial context at 4K–8K tokens and confirm 100% GPU/Metal offload before scaling context length.
- Can Hy3 run on a consumer laptop or smartphone?
- No smartphone or 8–16 GB laptop can hold Hy3 cleanly in local memory. It targets multi-GPU NVIDIA workstations, high-RAM Mac Studios, or MoE CPU-RAM hybrid rigs with at least 164.8 GB total memory.
- How does Hy3 compare to HunyuanImage 3.0?
- HunyuanImage 3.0 (80B, 44.7 GB min RAM) sits closest in size. Compare active parameters, context ceiling (256K vs 4K), and license terms (Apache 2.0) before switching.