logo
0
0
WeChat Login

中文 | English



License    HuggingFace    ModelScope    cnb.cool    GitCode

🖥️ Official Website  |   💬 GitHub


Table of Contents


Model Introduction

Hy3 preview is a 295B-parameter Mixture-of-Experts (MoE) model with 21B active parameters and 3.8B MTP layer parameters, developed by the Tencent Hy Team. Hy3 preview is the first model trained on our rebuilt infrastructure, and the strongest we've shipped so far. It improves significantly on complex reasoning, instruction following, context learning, coding, and agent tasks.

PropertyValue
ArchitectureMixture-of-Experts (MoE)
Total Parameters295B
Activated Parameters21B
MTP Layer Parameters3.8B
Number of Layers (excluding MTP layer)80
Number of MTP Layers1
Attention Heads64 (GQA, 8 KV heads, head dim 128)
Hidden Size4096
Intermediate Size13312
Context Length256K
Vocabulary Size120832
Number of Experts192 experts, top-8 activated
Supported PrecisionsBF16

Highlights

  • STEM & Reasoning — Complex reasoning underpins everything else. Hy3 preview performs well on challenging STEM benchmarks like FrontierScience-Olympiad and IMOAnswerBench, and achieved excellent results in the Tsinghua Qiuzhen College Math PhD qualifying exam (Spring '26) and the China High School Biology Olympiad (CHSBO 2025), demonstrating generalizable reasoning capacity.

  • Context Learning & Instruction Following — Real-world tasks require the ability to parse messy, lengthy contexts and follow complex rules. We built CL-bench and CL-bench-Life from our own business scenarios to innovatively measure context learning ability. Hy3 preview exhibits solid gains in both context learning and instruction following capabilities.

  • Code & Agent — Coding and agents saw the biggest gains. With a rebuilt RL infrastructure and larger-scale training tasks, we posted competitive scores across mainstream coding agent benchmarks (SWE-bench Verified, Terminal-Bench 2.0) and search agent benchmarks (BrowseComp, WideSearch).

Benchmark Results

Pre-trained Model Performance

CategoryBenchmark (Metric)# ShotsKimi-K2 BASEDeepSeek-V3 BASEGLM-4.5 BASEHy3 preview-Base
#ActivatedParams-32B37B32B21B
#TotalParams-1043B671B355B295B
EnglishMMLU5-shot88.2487.6887.7387.42
MMLU-Pro5-shot65.9863.9863.6765.76
MMLU-Redux5-shot87.1886.8186.5686.86
ARC-Challenge0-shot96.6694.6596.3295.99
DROP5-shot86.4086.5082.9085.50
PIQA4-shot84.9384.2284.7184.39
SuperGPQA5-shot51.1046.1749.6451.60
SimpleQA5-shot34.3726.1529.2626.47
CodeMBPP-plus3-shot81.3575.4778.0578.71
CRUXEval-I3-shot68.0167.7968.5171.19
CRUXEval-O3-shot69.6271.0067.7568.38
LiveCodeBench-v61-shot30.8629.3127.4334.86
MathGSM8K4-shot93.4688.1590.0695.37
MATH4-shot71.2059.3761.0076.28
CMath4-shot90.8385.5089.3391.17
ChineseC-Eval5-shot91.5190.3585.8489.80
CMMLU5-shot90.7287.9086.4689.61
Chinese-simpleQA5-shot74.5868.7268.4969.73
MultilingualMMMLU5-shot77.6379.5479.2680.15
INCLUDE5-shot75.6677.8676.2778.64

Instruct Model Performance

STEM & Reasoning

Complex reasoning underpins everything else. Hy3 preview performs well on challenging STEM benchmarks like FrontierScience-Olympiad and IMOAnswerBench. It also achieved excellent results in the Tsinghua Qiuzhen College Math PhD qualifying exam (Spring '26) and the China High School Biology Olympiad (CHSBO 2025), demonstrating a high degree of generalizable reasoning capacity.

STEM & Reasoning benchmarks

Context Learning & Instruction Following

Real-world tasks require the ability to parse messy, lengthy contexts and follow complex rules. We built CL-bench and CL-bench-Life from our own business scenarios to innovatively measure context learning ability. Hy3 preview exhibits solid gains in both context learning and instruction following capabilities.

Context Learning & Instruction Following benchmarks

Code & Agent

Coding and agents saw the biggest gains. With a rebuilt RL infrastructure and larger-scale training tasks, we posted competitive scores across mainstream coding agent benchmarks (SWE-bench Verified, Terminal-Bench 2.0) and search agent benchmarks (BrowseComp, WideSearch).

Agent benchmarks overview

Coding is about whether a model can execute in a development environment. Search is about whether it can find and combine information from the open web. Both matter for complex agent scenarios like OpenClaw. Hy3 preview scores well on ClawEval and WildClawBench — a sign that its agent capabilities are becoming practical.

Claw Agent benchmarks

Beyond public benchmarks, we built internal evaluation sets to test the model in real development scenarios. On Hy-Backend (backend-focused tasks), Hy-Vibe Bench (real-user dev workflows), and Hy-SWE Max, Hy3 preview scores competitively against other open-source models.

Internal benchmarks

News

Model Links

Model NameDescriptionHugging FaceModelScopeGitCode
Hy3 previewInstruct model🤗 ModelModelModel
Hy3 preview-BasePre-trained base model🤗 ModelModelModel

Quickstart

Deploy Hy3 preview with vLLM or SGLang first, then call the OpenAI-compatible API:

from openai import OpenAI client = OpenAI(base_url="http://localhost:8000/v1", api_key="EMPTY") response = client.chat.completions.create( model="tencent/Hy3-preview", messages=[ {"role": "user", "content": "Hello! Can you briefly introduce yourself?"}, ], temperature=0.9, top_p=1.0, # reasoning_effort: "no_think" (default, direct response), "low", "high" (deep chain-of-thought) extra_body={"chat_template_kwargs": {"reasoning_effort": "no_think"}}, ) print(response.choices[0].message.content)

Recommended parameters: temperature=0.9, top_p=1.0.

Reasoning mode: Set reasoning_effort to "high" for complex tasks (math, coding, reasoning) or "no_think" for direct responses.

See the Deployment section below for how to start the API server.

Deployment

Hy3-preview has 295B parameters in total. To serve it on 8 GPUs, we recommend using H20-3e or other GPUs with larger memory capacity.

vLLM

Build vLLM from source:

uv venv --python 3.12 --seed --managed-python source .venv/bin/activate git clone https://github.com/vllm-project/vllm.git cd vllm uv pip install --editable . --torch-backend=auto

Start the vLLM server with MTP enabled:

vllm serve tencent/Hy3-preview \ --tensor-parallel-size 8 \ --speculative-config.method mtp \ --speculative-config.num_speculative_tokens 1 \ --tool-call-parser hy_v3 \ --reasoning-parser hy_v3 \ --enable-auto-tool-choice \ --served-model-name hy3-preview

SGLang

Build SGLang from source:

git clone https://github.com/sgl-project/sglang cd sglang pip3 install pip --upgrade pip3 install "transformers>=5.6.0" pip3 install -e "python"

Launch SGLang server with MTP enabled:

python3 -m sglang.launch_server \ --model tencent/Hy3-preview \ --tp 8 \ --tool-call-parser hunyuan \ --reasoning-parser hunyuan \ --speculative-num-steps 1 \ --speculative-eagle-topk 1 \ --speculative-num-draft-tokens 2 \ --speculative-algorithm EAGLE \ --served-model-name hy3-preview

Training

Hy3 preview provides a complete model training pipeline, supporting both full fine-tuning and LoRA fine-tuning, with DeepSpeed ZeRO configurations and LLaMA-Factory integration.

For detailed training documentation, please refer to: Training Guide

Quantization

We provide AngelSlim, a more accessible, comprehensive, and efficient toolkit for large model compression. AngelSlim supports a comprehensive suite of compression tools for large-scale multimodal models, including common quantization algorithms, low-bit quantization, and speculative sampling.

License

Hy3 preview is released under the Tencent Hy Community License Agreement. See LICENSE for details.

Contact Us

If you would like to leave a message for our R&D and product teams, welcome to contact us. You can also reach us via email:

📧 hunyuan_opensource@tencent.com


Hy3 preview is developed by the Tencent Hy Team.