Skip to content

[TRTLLM-11548][doc] Add Qwen3.5 deployment guide doc - #15111

Merged
nv-guomingz merged 1 commit into
NVIDIA:mainfrom
nv-guomingz:user/guomingz/update_qwen3.5_doc
Jun 9, 2026
Merged

[TRTLLM-11548][doc] Add Qwen3.5 deployment guide doc#15111
nv-guomingz merged 1 commit into
NVIDIA:mainfrom
nv-guomingz:user/guomingz/update_qwen3.5_doc

Conversation

@nv-guomingz

@nv-guomingz nv-guomingz commented Jun 8, 2026

Copy link
Copy Markdown
Collaborator

Summary by CodeRabbit

Release Notes

  • New Features

    • Added support for Qwen3.5-397B-A17B-NVFP4 model variant with curated configuration for maximum throughput on B200/B300 and GB200/GB300 GPUs.
  • Documentation

    • Updated deployment guide with Qwen3.5-specific instructions, GPU requirements, tensor parallel settings, and troubleshooting guidance.
    • Updated supported models table to reflect Qwen3.5 model status.
    • Added example benchmarking configuration for the new model variant.

Description

Test Coverage

PR Checklist

Please review the following before submitting your PR:

  • PR description clearly explains what and why. If using CodeRabbit's summary, please make sure it makes sense.

  • PR Follows TRT-LLM CODING GUIDELINES to the best of your knowledge.

  • Test cases are provided for new code paths (see test instructions)

  • If PR introduces API changes, an appropriate PR label is added - either api-compatible or api-breaking. For api-breaking, include BREAKING in the PR title.

  • Any new dependencies have been scanned for license and vulnerabilities

  • CODEOWNERS updated if ownership changes

  • Documentation updated as needed

  • Update tava architecture diagram if there is a significant design change in PR.

  • The reviewers assigned automatically/manually are appropriate for the PR.

  • Please check this after reviewing the above items as appropriate for this PR.

GitHub Bot Help

To see a list of available CI bot commands, please comment /bot help.

@nv-guomingz
nv-guomingz requested a review from a team as a code owner June 8, 2026 14:58
@coderabbitai

coderabbitai Bot commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

📝 Walkthrough

Walkthrough

This PR introduces support for the nvidia/Qwen3.5-397B-A17B-NVFP4 model to TensorRT LLM by adding a curated configuration, metadata mappings, and comprehensive deployment documentation. All necessary runtime settings, GPU compatibility declarations, and user-facing guidance are included.

Changes

Qwen3.5 Model Onboarding

Layer / File(s) Summary
Curated Configuration Setup
examples/configs/curated/lookup.yaml, examples/configs/curated/qwen3.5.yaml, scripts/generate_config_table.py, docs/source/_static/config_db.json
Model nvidia/Qwen3.5-397B-A17B-NVFP4 is registered in the model class mapping to Qwen3_5MoeForCausalLM with the new qwen3.5.yaml configuration file, GPU compatibility list B200, B300, GB200, GB300, and "Max Throughput" scenario. The configuration file defines batch/token limits, tensor and MoE parallelism, attention DP, KV cache memory tuning, and postprocess worker settings. Model metadata (display name and Hugging Face URL) is added to config_db.json curated entries and models map, and to the MODEL_INFO table for doc generation.
Deployment Guide and Documentation
docs/source/deployment-guide/deployment-guide-for-qwen3.5-on-trtllm.md, docs/source/deployment-guide/index.rst, docs/source/models/supported-models.md
Deployment guide is updated from Qwen3-Next to Qwen3.5, documenting the NVFP4 checkpoint architecture, GPU requirements, Docker container setup referencing qwen3.5.yaml, trtllm-serve launch with qwen3_5/qwen3 parsers, YAML API options including new enable_attention_dp, KV cache guidance, chat-completions request example, and Qwen3.5-specific troubleshooting including reasoning toggle via chat_template_kwargs.enable_thinking. Benchmarking wrapper is updated to use the Qwen3.5 model. Navigation index updated to reference the qwen3.5 guide, and supported-models table footnote removed from Qwen3_5MoeForCausalLM entry.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

  • NVIDIA/TensorRT-LLM#14964: Adds "Max Throughput" NVFP4 model documentation for a different model ID using the same curated configuration system and metadata tables.

Suggested reviewers

  • QiJune
  • laikhtewari
🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Description check ⚠️ Warning The PR description is incomplete, containing only the template structure without substantive content explaining the changes, objectives, or test coverage. Fill in the Description section explaining what Qwen3.5 deployment guide was added and why; detail test coverage for documentation changes; ensure the PR title follows the specified format with ticket ID and type.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly summarizes the main change: adding a Qwen3.5 deployment guide documentation. It includes the JIRA ticket, type indicator, and concise description.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Comment @coderabbitai help to get the list of available commands and usage tips.

@nv-guomingz
nv-guomingz force-pushed the user/guomingz/update_qwen3.5_doc branch from 61c8da9 to 4f8cdd5 Compare June 8, 2026 15:11
@nv-guomingz

Copy link
Copy Markdown
Collaborator Author

/bot run

@tensorrt-cicd

Copy link
Copy Markdown
Collaborator

PR_Github #52802 [ run ] triggered by Bot. Commit: 4f8cdd5 Link to invocation

@nv-guomingz
nv-guomingz enabled auto-merge (squash) June 8, 2026 15:24
Comment thread docs/source/deployment-guide/deployment-guide-for-qwen3.5-on-trtllm.md Outdated

@arysef arysef left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

approved with suggestions

Signed-off-by: nv-guomingz <137257613+nv-guomingz@users.noreply.github.com>
@nv-guomingz
nv-guomingz force-pushed the user/guomingz/update_qwen3.5_doc branch from 4f8cdd5 to 23d4cbf Compare June 8, 2026 16:29
@nv-guomingz

Copy link
Copy Markdown
Collaborator Author

/bot run

@tensorrt-cicd

Copy link
Copy Markdown
Collaborator

PR_Github #52815 [ run ] triggered by Bot. Commit: 23d4cbf Link to invocation

@tensorrt-cicd

Copy link
Copy Markdown
Collaborator

PR_Github #52802 [ run ] completed with state ABORTED. Commit: 4f8cdd5

Link to invocation

@tensorrt-cicd

Copy link
Copy Markdown
Collaborator

PR_Github #52815 [ run ] completed with state SUCCESS. Commit: 23d4cbf
/LLM/main/L0_MergeRequest_PR pipeline #42069 completed with status: 'FAILURE'

CI Report

⚠️ Action Required:

  • Please check the failed tests and fix your PR
  • If you cannot view the failures, ask the CI triggerer to share details
  • Once fixed, request an NVIDIA team member to trigger CI again

CI Agent Failure Analysis

Link to invocation

@nv-guomingz

Copy link
Copy Markdown
Collaborator Author

/bot run --disable-fail-fast

@tensorrt-cicd

Copy link
Copy Markdown
Collaborator

PR_Github #52881 [ run ] triggered by Bot. Commit: 23d4cbf Link to invocation

@tensorrt-cicd

Copy link
Copy Markdown
Collaborator

PR_Github #52881 [ run ] completed with state SUCCESS. Commit: 23d4cbf
/LLM/main/L0_MergeRequest_PR pipeline #42132 completed with status: 'SUCCESS'
Pipeline passed with automatic retried tests. Check the rerun report for details.

CI Report

Link to invocation

@nv-guomingz
nv-guomingz merged commit 09ebc59 into NVIDIA:main Jun 9, 2026
7 checks passed
crazydemo pushed a commit to crazydemo/TensorRT-LLM that referenced this pull request Jun 9, 2026
Signed-off-by: nv-guomingz <137257613+nv-guomingz@users.noreply.github.com>
@nv-guomingz
nv-guomingz deleted the user/guomingz/update_qwen3.5_doc branch June 23, 2026 12:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants