Tencent’s Hy staff launched Hy3. Hy3 is a 295B-parameter Combination-of-Consultants (MoE) mannequin. It prompts solely 21B parameters per token. The weights ship beneath the Apache License 2.0. Hy3 is geared toward reasoning, agentic workflows, and long-context duties.
What’s Hy3?
Hy3’s structure incorporates a sparse MoE with 192 specialists and top-8 routing. Solely 8 specialists hearth per token, so compute stays low.
The mannequin additionally makes use of a Multi-Token Prediction (MTP) layer. MTP predicts a number of tokens directly for quicker decoding. Each vLLM and SGLang allow it via speculative decoding.
| Property | Worth |
|---|---|
| Structure | Combination-of-Consultants (MoE) |
| Whole parameters | 295B |
| Activated parameters | 21B |
| MTP layer parameters | 3.8B |
| Layers (excluding MTP) | 80 |
| MTP layers | 1 |
| Consideration heads | 64 (GQA, 8 KV heads, head dim 128) |
| Hidden measurement | 4096 |
| Intermediate measurement | 13312 |
| Context size | 256K |
| Vocabulary measurement | 120832 |
| Consultants | 192 specialists, top-8 activated |
| Supported precisions | BF16 |
A separate Hy3-FP8 checkpoint can be launched. FP8 lowers the reminiscence footprint for cheaper serving.
Benchmark and Efficiency
The analysis staff printed scores throughout coding, brokers, and STEM. On coding, Hy3 studies 78.0 on SWE-Bench Verified. It additionally studies 57.9 on SWE-Bench Professional and 75.8 on SWE-Bench Multilingual. Terminal-Bench 2.1 lands at 71.7, and DeepSWE at 28.0.
On STEM and reasoning, the numbers climb increased. Hy3 studies 90.4 on GPQA Diamond and 72.0 on USAMO 2026. IMOAnswerBench reaches 90.0, and HLE (with instruments) reaches 53.2.
The analysis staff ran a blind check with 270 specialists. That check collected 312 legitimate comparisons on actual workflows. Hy3 scored 2.67 out of 4, forward of GLM-5.1 at 2.51. The sting was clearest in frontend improvement, CI/CD, and knowledge and storage.


Reliability and Manufacturing Habits
The analysis staff centered a lot of this launch on manufacturing reliability. Three failure modes acquired direct consideration, backed by inside numbers.
- Software calling and output formatting: The staff fastened baseline stability points that broke brokers. Invalid calls that set off infinite loops dropped. Hy3 additionally generalizes throughout agent scaffoldings. On SWE-Bench Verified, accuracy variance throughout CodeBuddy, Cline, and KiloCode stays inside 4%.
- World data and anti-hallucination: The goal habits is straightforward: reply when grounded, flag when proof is lacking. In inside evaluations, the hallucination price fell from 12.5% to five.4%. Commonsense error charges fell from 25.4% to 12.7%.
- Multi-turn intent monitoring: Joint SFT and RL improved coreference and constraint monitoring. The interior problem price dropped from 17.4% to 7.9%. On the MRCR long-dialogue benchmark, scores rose from 42.9% to 75.1%.
Tips on how to Name Hy3
Hy3 exposes an OpenAI-compatible API. You deploy it with vLLM or SGLang, then name the endpoint. One flag, reasoning_effort, controls how a lot the mannequin thinks.
from openai import OpenAI
shopper = OpenAI(base_url="http://127.0.0.1:8000/v1", api_key="EMPTY")
response = shopper.chat.completions.create(
mannequin="hy3",
messages=[
{"role": "user", "content": "Refactor this function and explain the change."},
],
temperature=0.9,
top_p=1.0,
# reasoning_effort: "no_think" (default), "low", "excessive" (deep chain-of-thought)
extra_body={"chat_template_kwargs": {"reasoning_effort": "excessive"}},
)
print(response.decisions[0].message.content material)
Use no_think for direct solutions, and excessive for math, coding, or multi-step duties. Tencent analysis staff recommends temperature=0.9 and top_p=1.0. It’s also possible to attempt Hy3 with out native {hardware}. OpenRouter lists a tencent/hy3:free route at $0 per token. That free tier is scheduled to finish on July 21, 2026.
The place Hy3 Matches: Use Circumstances
Hy3 is constructed round agent-style, long-context work. A couple of concrete examples:
- Coding brokers: Feed a full repository into the 256K window. Ask Hy3 to repair a failing check with
reasoning_effort="excessive". Secure software calls assist it run edits throughout many information. - Doc processing: Move a protracted contract or submitting as context. The anti-hallucination coaching reduces fabricated clauses and misquotes.
- Monetary evaluation: Mix tables and prose in a single immediate. Ask for a grounded abstract that flags lacking knowledge slightly than guessing.
- Frontend and recreation improvement: Generate a React part or a small recreation loop. The blind check confirmed a frontend benefit over GLM-5.1.
Hy3 vs GLM-5.2
Tencent’s analysis staff benchmarked Hy3 in opposition to GLM-5.2 in its personal appendix. GLM-5.2 is roughly a 744B MoE with about 40B energetic parameters. Hy3 is lower than half that complete measurement, with 21B energetic. On coding, GLM-5.2 leads throughout the suite.
| Benchmark | Hy3 (21B energetic) | GLM-5.2 (~40B energetic) |
|---|---|---|
| SWE-Bench Verified | 78.0 | 84.2 |
| SWE-Bench Multilingual | 75.8 | 83.0 |
| Terminal-Bench 2.1 | 71.7 | 81.0 |
| DeepSWE | 28.0 | 46.2 |
| Whole / energetic params | 295B / 21B | ~744B / ~40B |
| License | Apache 2.0 | Open weights |
The main target right here is about measurement, not simply rating. Hy3 trades some coding accuracy for a much smaller energetic footprint. That footprint issues whenever you self-host and pay for GPUs.
Deployment Notes
Hy3 has 295B complete parameters, so serving wants actual reminiscence. Tencent’s analysis staff recommends 8 GPUs, such because the H20-3e or playing cards with bigger reminiscence. vLLM and SGLang each ship recipes with MTP enabled. A minimal vLLM launch seems to be like this:
vllm serve tencent/Hy3
--tensor-parallel-size 8
--speculative-config.methodology 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
For compression, The analysis staff factors to its AngelSlim toolkit. AngelSlim covers quantization, low-bit strategies, and speculative sampling. Tencent additionally gives a whole finetuning pipeline for Hy3.
Attempt It: Interactive Explorer
The demo under is an interactive explorer for Hy3. It visualizes MoE routing, reasoning modes, benchmarks, and sparse effectivity.
