Skip to content

[None][doc] Add Qwen3.8 deployment guide and configs - #17594

Merged
Wanli-Jiang merged 1 commit into
NVIDIA:mainfrom
Wanli-Jiang:user/williamj/qwen38-doc
Aug 13, 2026
Merged

[None][doc] Add Qwen3.8 deployment guide and configs#17594
Wanli-Jiang merged 1 commit into
NVIDIA:mainfrom
Wanli-Jiang:user/williamj/qwen38-doc

Conversation

@Wanli-Jiang

@Wanli-Jiang Wanli-Jiang commented Aug 13, 2026

Copy link
Copy Markdown
Collaborator

Dev Engineer Review

  • Added Qwen3.8 deployment documentation and updated related model and MTP documentation.
  • Added four curated Qwen3.8 configurations for low-latency and high-throughput workloads, with and without MTP3.
  • Added Qwen3.8 metadata to the configuration database and supported-models documentation.
  • Updated command generation to preserve repository-relative configuration paths.
  • Review YAML values, model identifiers, GPU targets, parallelism settings, and MTP3 options for consistency with TensorRT-LLM support.
  • Confirm that generated commands resolve configuration paths correctly.
  • Confirm that the combined deployment guide preserves the required Qwen3.5 deployment content.

QA Engineer Review

No test changes.

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.

@Wanli-Jiang

Copy link
Copy Markdown
Collaborator Author

/bot run --disable-fail-fast

@coderabbitai

coderabbitai Bot commented Aug 13, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: c7b241a0-97a1-46d5-a5bb-933cc9187e1e

📥 Commits

Reviewing files that changed from the base of the PR and between 6278691 and fad750a.

📒 Files selected for processing (4)
  • examples/configs/curated/qwen3.8-high-throughput-mtp3.yaml
  • examples/configs/curated/qwen3.8-high-throughput.yaml
  • examples/configs/curated/qwen3.8-low-latency-mtp3.yaml
  • examples/configs/curated/qwen3.8-low-latency.yaml
🚧 Files skipped from review as they are similar to previous changes (4)
  • examples/configs/curated/qwen3.8-low-latency.yaml
  • examples/configs/curated/qwen3.8-high-throughput-mtp3.yaml
  • examples/configs/curated/qwen3.8-high-throughput.yaml
  • examples/configs/curated/qwen3.8-low-latency-mtp3.yaml

Walkthrough

Added Qwen3.8 curated serving configurations, repository-relative command handling, and a combined Qwen3.8/Qwen3.5 deployment guide. Updated model support, MTP support, documentation navigation, and configuration metadata.

Changes

Qwen3.8 deployment support

Layer / File(s) Summary
Curated configuration profiles
examples/configs/curated/*, examples/configs/curated/lookup.yaml, docs/source/_static/config_db.json
Added four Qwen3.8 FP8 profiles for low-latency and high-throughput serving, with and without MTP3. Added model metadata and GPU mappings.
Serving command generation
scripts/generate_config_table.py, docs/source/_static/config_selector.js
Added YAML inspection and conditional cd "${TRTLLM_DIR}" handling for repository-relative configuration references.
Deployment documentation and support references
docs/source/deployment-guide/..., docs/source/deployment-guide/index.rst, docs/source/features/speculative-decoding.md, docs/source/models/supported-models.md
Added deployment, benchmarking, configuration, troubleshooting, and parser guidance. Updated MTP support, model support, and deployment-guide navigation.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Mergeability Score: 🟡 Moderate · up to fad75

The deployment guide and associated configuration document conflicting MTP3 concurrency settings, which could lead users to run misleading benchmarks and make incorrect capacity or performance decisions. Merge should wait for the inconsistency to be corrected or explicitly accepted by the owner.

Sequence Diagram(s)

sequenceDiagram
  participant ConfigTable as generate_config_table.py
  participant Selector as config_selector.js
  participant Server as trtllm-serve
  ConfigTable->>Selector: Generate serving command
  Selector->>Selector: Add repository directory when required
  Selector->>Server: Run with selected configuration
Loading

Suggested reviewers: brnguyen2, laikhtewari

🚥 Pre-merge checks | ✅ 3 | ❌ 2

❌ Failed checks (2 warnings)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 25.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
Description check ⚠️ Warning The description includes the template but provides no issue summary or test coverage details; only the final checklist item is checked. Add a concise Description section explaining the changes and motivation, and list relevant test coverage or validation results.
✅ Passed checks (3 passed)
Check name Status Explanation
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.
Title check ✅ Passed The title follows the required format and clearly summarizes the added Qwen3.8 deployment guide and configuration files.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

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

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In
`@docs/source/deployment-guide/deployment-guide-for-qwen3.8-qwen3.5-on-trtllm.md`:
- Line 55: Resolve the inconsistency between the MTP3 profile’s max_batch_size,
the concurrency value in the “High throughput” table row, and the attention-DP
scaling rule near the sweep-limit definition. Align these values so the
documented concurrency does not exceed max_batch_size * num_gpus, updating the
performance value, profile setting, or scaling rule as appropriate while
preserving the intended MTP3 benchmark configuration.

In `@scripts/generate_config_table.py`:
- Around line 162-169: Annotate the node parameter of the nested walk function
with object while preserving its existing boolean return annotation and
traversal behavior.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: 9038d75b-d7a3-4934-8c80-dca558953ffe

📥 Commits

Reviewing files that changed from the base of the PR and between 6e931c9 and 6278691.

📒 Files selected for processing (15)
  • docs/source/_static/config_db.json
  • docs/source/_static/config_selector.js
  • docs/source/deployment-guide/deployment-guide-for-qwen3.5-on-trtllm.md
  • docs/source/deployment-guide/deployment-guide-for-qwen3.8-qwen3.5-on-trtllm.md
  • docs/source/deployment-guide/index.rst
  • docs/source/features/speculative-decoding.md
  • docs/source/models/supported-models.md
  • examples/configs/curated/eplb/qwen3.8-ep32-static544-mtp3.yaml
  • examples/configs/curated/eplb/qwen3.8-ep32-static544.yaml
  • examples/configs/curated/lookup.yaml
  • examples/configs/curated/qwen3.8-high-throughput-mtp3.yaml
  • examples/configs/curated/qwen3.8-high-throughput.yaml
  • examples/configs/curated/qwen3.8-low-latency-mtp3.yaml
  • examples/configs/curated/qwen3.8-low-latency.yaml
  • scripts/generate_config_table.py
💤 Files with no reviewable changes (1)
  • docs/source/deployment-guide/deployment-guide-for-qwen3.5-on-trtllm.md

Comment thread scripts/generate_config_table.py
@tensorrt-cicd

Copy link
Copy Markdown
Collaborator

PR_Github #65763 [ run ] triggered by Bot. Commit: 6278691 Link to invocation

Comment thread examples/configs/curated/qwen3.8-high-throughput-mtp3.yaml Outdated
@tensorrt-cicd

Copy link
Copy Markdown
Collaborator

PR_Github #65763 [ run ] completed with state FAILURE. Commit: 6278691
/LLM/main/L0_MergeRequest_PR pipeline #53474 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

@Wanli-Jiang

Copy link
Copy Markdown
Collaborator Author

/bot run --disable-fail-fast

@tensorrt-cicd

Copy link
Copy Markdown
Collaborator

PR_Github #65832 [ run ] triggered by Bot. Commit: 6278691 Link to invocation

@tensorrt-cicd

Copy link
Copy Markdown
Collaborator

PR_Github #65832 [ run ] completed with state FAILURE. Commit: 6278691
/LLM/main/L0_MergeRequest_PR pipeline #53530 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

@Wanli-Jiang
Wanli-Jiang force-pushed the user/williamj/qwen38-doc branch from 6278691 to e9752cf Compare August 13, 2026 09:06
Signed-off-by: Wanli Jiang <35160485+Wanli-Jiang@users.noreply.github.com>
@Wanli-Jiang
Wanli-Jiang force-pushed the user/williamj/qwen38-doc branch from e9752cf to fad750a Compare August 13, 2026 09:07
@Wanli-Jiang Wanli-Jiang changed the title [None][docs] Add Qwen3.8 deployment guide and configs [None][doc] Add Qwen3.8 deployment guide and configs Aug 13, 2026
@Wanli-Jiang

Copy link
Copy Markdown
Collaborator Author

/bot run --disable-fail-fast

@tensorrt-cicd

Copy link
Copy Markdown
Collaborator

PR_Github #65861 [ run ] triggered by Bot. Commit: fad750a Link to invocation

@tensorrt-cicd

Copy link
Copy Markdown
Collaborator

PR_Github #65861 [ run ] completed with state FAILURE. Commit: fad750a
/LLM/main/L0_MergeRequest_PR pipeline #53554 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

@Wanli-Jiang

Copy link
Copy Markdown
Collaborator Author

/bot skip --comment "skip since the failures are not related with code changes"

@tensorrt-cicd

Copy link
Copy Markdown
Collaborator

PR_Github #65925 [ skip ] triggered by Bot. Commit: fad750a Link to invocation

@tensorrt-cicd

Copy link
Copy Markdown
Collaborator

PR_Github #65925 [ skip ] completed with state SUCCESS. Commit: fad750a
Skipping testing for commit fad750a

Link to invocation

@Wanli-Jiang
Wanli-Jiang merged commit 20cc428 into NVIDIA:main Aug 13, 2026
13 checks passed
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