Skip to content

[Doc]Add InternVL3.5 documentation - #9980

Merged
weijinqian0 merged 1 commit into
vllm-project:mainfrom
nakairika:internvl
Jun 5, 2026
Merged

[Doc]Add InternVL3.5 documentation#9980
weijinqian0 merged 1 commit into
vllm-project:mainfrom
nakairika:internvl

Conversation

@nakairika

@nakairika nakairika commented Jun 4, 2026

Copy link
Copy Markdown
Contributor

What this PR does / why we need it?

Upload doc for InternVL3_5 on Ascend

Does this PR introduce any user-facing change?

How was this patch tested?

ci test refers to #10002

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Jun 4, 2026
@github-actions

github-actions Bot commented Jun 4, 2026

Copy link
Copy Markdown
Contributor

👋 Hi! Thank you for contributing to the vLLM Ascend project. The following points will speed up your PR merge:‌‌

  • A PR should do only one thing, smaller PRs enable faster reviews.
  • Every PR should include unit tests and end-to-end tests ‌to ensure it works and is not broken by other future PRs.
  • Write the commit message by fulfilling the PR description to help reviewer and future developers understand.

If CI fails, you can run linting and testing checks locally according Contributing and Testing.

@gemini-code-assist

Copy link
Copy Markdown
Contributor

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request introduces documentation for the InternVL3.5 multimodal model family. It provides users with necessary environment preparation steps, deployment configurations for both single and multi-NPU setups, and guidance on performing accuracy and performance evaluations within the vLLM-Ascend ecosystem.

Highlights

  • Documentation Addition: Added comprehensive documentation for the InternVL3.5 model family, including setup, deployment, and evaluation instructions.
  • Model Support: Included specific guidance for deploying InternVL3_5-38B and InternVL3_5-241B-A28B models on Ascend NPU environments.
New Features

🧠 You can now enable Memory (public preview) to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize the Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counterproductive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@gemini-code-assist gemini-code-assist 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.

Code Review

This pull request introduces documentation for the InternVL3.5 model family on Ascend NPUs, covering installation, deployment, accuracy evaluation, and performance benchmarking. The review feedback suggests updating the PR title and summary to comply with the repository's style guide, and fixing a tab synchronization conflict where the model selection tab-set incorrectly shares the 'install' sync-group with the installation tab-set.

@@ -0,0 +1,288 @@
# InternVL3.5(InternVL3_5-38B/-241B-A28B)

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.

high

Please update the Pull Request title and summary to adhere to the repository's Pull Request Summary Style Guide.

Suggested PR Title:

[Doc][Misc] Add InternVL3.5 documentation

Suggested PR Summary:

### What this PR does / why we need it?

This PR adds the documentation for the `InternVL3.5` family of models (`InternVL3_5-38B` and `InternVL3_5-241B-A28B`) on Ascend NPUs. It covers supported features, environment preparation (including Docker container setup), deployment (online serving), accuracy evaluation using `lm_eval`, and performance benchmarking.

### Does this PR introduce _any_ user-facing change?

No, this is a documentation-only update.

### How was this patch tested?

This is a documentation update and does not require code testing.
References
  1. The Pull Request title and summary must follow the format specified in the Pull Request Summary Style Guide. (link)

Comment on lines +113 to +114
:::::{tab-set}
:sync-group: install

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.

high

The sync-group for the model selection tab-set is set to install, which is the same as the installation tab-set. Since both tab-sets share the same sync-group and some tab-items share the sync key multi, clicking a model tab (e.g., InternVL3_5-241B-A28B) will unexpectedly switch the active tab in the installation section. Please change the sync-group to a different identifier, such as model, to keep these tab-sets independent.

Suggested change
:::::{tab-set}
:sync-group: install
::::::{tab-set}
::sync-group: model

@nakairika
nakairika force-pushed the internvl branch 2 times, most recently from 347a7f2 to a1d2a57 Compare June 4, 2026 06:58
@nakairika nakairika changed the title [Doc]Add InternVL3_5 documentation [Doc]Add InternVL3.5 documentation Jun 4, 2026
Signed-off-by: nakairika <35144242+nakairika@users.noreply.github.com>
::::
:::::

If you want to deploy multi-node environment, you need to set up environment on each node.

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.

should we add doc for multi-node?

export IMAGE=quay.io/ascend/vllm-ascend:|vllm_ascend_version|

docker run --rm \
--name $NAME \

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.

it seems like this env is not defined.

```shell
lm_eval \
--model vllm-vlm \
--model_args pretrained=OpenGVLab/InternVL3_5-38B,max_model_len=8192,gpu_memory_utilization=0.7 \

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.

As an example, take the mmmu_valdataset as a test dataset, and run accuracy evaluation ofInternVL3_5-241B-A28B in offline mode. you shell script is not matched with description.

@weijinqian0
weijinqian0 merged commit 4df6e3a into vllm-project:main Jun 5, 2026
35 checks passed
AuroraEmiya pushed a commit to AuroraEmiya/vllm-ascend that referenced this pull request Jun 5, 2026
### What this PR does / why we need it?
Upload doc for InternVL3_5 on Ascend
### Does this PR introduce _any_ user-facing change?

### How was this patch tested?
ci test refers to vllm-project#10002

- vLLM version: v0.20.2
- vLLM main:
vllm-project/vllm@9090368

Signed-off-by: nakairika <35144242+nakairika@users.noreply.github.com>
chen-commits pushed a commit to chen-commits/vllm-ascend that referenced this pull request Jun 6, 2026
… into main-dsv4

* 'main-dsv4' of https://github.com/chen-commits/vllm-ascend: (35 commits)
  测试qwen3.5-122B
  [BugFix][UT] Fix platform eager mode log assertion (vllm-project#10075)
  [Misc] Use logger.info_once for enable_npugraph_ex log (vllm-project#9699)
  [CI] delete DeepSeek-R1-W8A8.yaml update DeepSeek-R1-0528-W8A8-EPLB.yaml (vllm-project#10055)
  [CI] fix ci error when rebase on latest main (vllm-project#10057)
  [CI] Upgrade the image version of pr_e2e_comment (vllm-project#10052)
  [BugFix] Include zero cached prompt token details (vllm-project#9911)
  [Doc][Misc] Update release notes known issues (vllm-project#10039)
  [Doc]Update MiniMax-M2.5.md change A2 to single node (vllm-project#9481)
  [Doc]Add InternVL3.5 documentation (vllm-project#9980)
  [BugFix]Fix the question that cant find num_kv_head from some model config (vllm-project#10008)
  [Ascend950][BugFix] Fix MoonViT3dPretrainedModel.to overriding quantized ViT weight dtype (vllm-project#9929)
  [CI][Test] Optimize selective test routing and CI test stability (vllm-project#9994)
  [BugFix] fix dsv4 piecewise scenario (vllm-project#10003)
  [Test][CI] final part for selected test (vllm-project#10017)
  [Feature] Enable prefix caching with PCP/DCP (vllm-project#9638)
  [Doc]Update GLM-5 documentation and support matrix (vllm-project#9889)
  [CI] add MiniMax A2 acc case (vllm-project#9855)
  [Bugfix] [kimi] upgrade transformers from 5.5.3 to 5.5.4 (vllm-project#9996)
  [Doc][Model] Add DeepSeek-V4 Flash and Pro documentation (vllm-project#9995)
  ...
calyoung80 pushed a commit to calyoung80/vllm-ascend that referenced this pull request Jun 7, 2026
### What this PR does / why we need it?
Upload doc for InternVL3_5 on Ascend
### Does this PR introduce _any_ user-facing change?

### How was this patch tested?
ci test refers to vllm-project#10002

- vLLM version: v0.20.2
- vLLM main:
vllm-project/vllm@9090368

Signed-off-by: nakairika <35144242+nakairika@users.noreply.github.com>
Signed-off-by: calyoung80 <zsucal@hotmail.com>
Signed-off-by: BobQiu1981 <qiumingbo81@163.com>
LostFox11 pushed a commit to LostFox11/vllm-ascend that referenced this pull request Jun 15, 2026
### What this PR does / why we need it?
Upload doc for InternVL3_5 on Ascend
### Does this PR introduce _any_ user-facing change?

### How was this patch tested?
ci test refers to vllm-project#10002

- vLLM version: v0.20.2
- vLLM main:
vllm-project/vllm@9090368

Signed-off-by: nakairika <35144242+nakairika@users.noreply.github.com>
LostFox11 pushed a commit to LostFox11/vllm-ascend that referenced this pull request Jun 15, 2026
### What this PR does / why we need it?
Upload doc for InternVL3_5 on Ascend
### Does this PR introduce _any_ user-facing change?

### How was this patch tested?
ci test refers to vllm-project#10002

- vLLM version: v0.20.2
- vLLM main:
vllm-project/vllm@9090368

Signed-off-by: nakairika <35144242+nakairika@users.noreply.github.com>
ader47 pushed a commit to ader47/vllm-ascend that referenced this pull request Jun 18, 2026
### What this PR does / why we need it?
Upload doc for InternVL3_5 on Ascend
### Does this PR introduce _any_ user-facing change?

### How was this patch tested?
ci test refers to vllm-project#10002

- vLLM version: v0.20.2
- vLLM main:
vllm-project/vllm@9090368

Signed-off-by: nakairika <35144242+nakairika@users.noreply.github.com>
CXY-Katrina pushed a commit to CXY-Katrina/vllm-ascend that referenced this pull request Jun 27, 2026
### What this PR does / why we need it?
Upload doc for InternVL3_5 on Ascend
### Does this PR introduce _any_ user-facing change?

### How was this patch tested?
ci test refers to vllm-project#10002

- vLLM version: v0.20.2
- vLLM main:
vllm-project/vllm@9090368

Signed-off-by: nakairika <35144242+nakairika@users.noreply.github.com>
HaoxinZong pushed a commit to HaoxinZong/vllm-ascend that referenced this pull request Jun 27, 2026
### What this PR does / why we need it?
Upload doc for InternVL3_5 on Ascend
### Does this PR introduce _any_ user-facing change?

### How was this patch tested?
ci test refers to vllm-project#10002

- vLLM version: v0.20.2
- vLLM main:
vllm-project/vllm@9090368

Signed-off-by: nakairika <35144242+nakairika@users.noreply.github.com>
pisceskkk pushed a commit to pisceskkk/vllm-ascend that referenced this pull request Jun 29, 2026
### What this PR does / why we need it?
Upload doc for InternVL3_5 on Ascend
### Does this PR introduce _any_ user-facing change?

### How was this patch tested?
ci test refers to vllm-project#10002

- vLLM version: v0.20.2
- vLLM main:
vllm-project/vllm@9090368

Signed-off-by: nakairika <35144242+nakairika@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants