Skip to content

Enabled BnB NF4 inference on Gaudi #20172

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

rsshaik1
Copy link
Contributor

@rsshaik1 rsshaik1 commented Jun 27, 2025

This PR adds inference tests for bitsandbytes NF4 quantization on Gaudi, supporting both pre-quantized models and models that are quantized at runtime.

Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

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

Summary of Changes

Hello @rsshaik1, 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 support for bitsandbytes NF4 quantization on Gaudi, enhancing the inference capabilities of vLLM. It includes comprehensive tests to validate the functionality and ensures correct device placement for optimal performance. The registration of the custom operator has also been updated to accommodate different platforms.

Highlights

  • Gaudi Support: Enabled bitsandbytes NF4 quantization inference on Gaudi.
  • Inference Tests: Added inference tests for bitsandbytes NF4 quantization, covering both pre-quantized models and models quantized at runtime.
  • Device Placement: Ensured that weights are loaded onto the appropriate device (CUDA or HPU) for bitsandbytes operations.
  • Custom Operator Registration: Modified the registration of the apply_bnb_4bit custom operator to include a dispatch key for the current platform.
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 in your pull request via creating an issue comment (i.e. comment on the pull request page) using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands.

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 issue comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize 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 is currently in preview and may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments to provide feedback.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

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.

Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

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 successfully enables BitsAndBytes NF4 quantization for Gaudi (HPU) devices, which is a significant step towards broader hardware support. The changes to the bitsandbytes_loader.py and bitsandbytes.py files correctly adapt the quantization logic and custom operation dispatching for HPU. The new test file test_bitsandbytes_hpu.py introduces specific tests for this functionality. However, the test suite has some areas for improvement, including an incorrect docstring reference, the use of hardcoded local model paths, and a critical issue where the is_quant_method_supported utility does not properly detect HPU support, potentially leading to inaccurate test results. Addressing these points will enhance the robustness and maintainability of the test suite.

Comment on lines 76 to 77
@pytest.mark.skipif(not is_quant_method_supported("bitsandbytes"),
reason='bitsandbytes is not supported on this GPU type.')
Copy link
Contributor

Choose a reason for hiding this comment

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

high

The @pytest.mark.skipif condition relies on is_quant_method_supported("bitsandbytes"). However, the is_quant_method_supported function (in tests/quantization/utils.py) currently only checks for CUDA or ROCm platforms and does not explicitly account for HPU (Gaudi) devices. This could lead to tests being incorrectly skipped or run when bitsandbytes support on HPU is not properly detected, impacting test correctness for the target platform.

@@ -0,0 +1,156 @@
# SPDX-License-Identifier: Apache-2.0
"""Tests whether bitsandbytes computation is enabled correctly.
Run `pytest tests/quantization/test_bitsandbytes.py`.
Copy link
Contributor

Choose a reason for hiding this comment

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

medium

The docstring for this test file incorrectly references test_bitsandbytes.py. It should refer to test_bitsandbytes_hpu.py to accurately reflect the file being tested.

Suggested change
Run `pytest tests/quantization/test_bitsandbytes.py`.
Run `pytest tests/quantization/test_bitsandbytes_hpu.py`.

Copy link
Collaborator

Choose a reason for hiding this comment

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

Will test_bitsandbytes.py be triggered on the current CI?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

No @jeejeelee as it skips the tests

Comment on lines 18 to 21
"/mnt/weka/data/pytorch/mistral/Mistral-7B-Instruct-v0.3",
"quantize_inflight_model_with_both_HF_and_Mistral_format_weights",
),
("meta-llama/Llama-3.2-1B", "quantize_llama_model_inflight"),
Copy link
Contributor

Choose a reason for hiding this comment

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

medium

Using hardcoded local paths like /mnt/weka/data/pytorch/mistral/Mistral-7B-Instruct-v0.3 in tests can reduce portability and make it difficult to run tests in different environments. Consider using publicly available Hugging Face model names or a more flexible mechanism for model paths if local models are strictly necessary for specific test cases.

f"Mismatch between HF and vLLM outputs:\n"
f"Prompt: {prompt}\n"
f"HF Output: '{hf_str}'\n"
f"vLLM Output: '{vllm_str}'")
Copy link
Contributor

Choose a reason for hiding this comment

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

medium

Python files should typically end with a newline character for better compatibility with various tools and version control systems.

Suggested change
f"vLLM Output: '{vllm_str}'")
f"HF Output: '{hf_str}'\n")

Copy link

👋 Hi! Thank you for contributing to the vLLM project.

💬 Join our developer Slack at https://slack.vllm.ai to discuss your PR in #pr-reviews, coordinate on features in #feat- channels, or join special interest groups in #sig- channels.

Just a reminder: PRs would not trigger full CI run by default. Instead, it would only run fastcheck CI which starts running only a small and essential subset of CI tests to quickly catch errors. You can run other CI tests on top of those by going to your fastcheck build on Buildkite UI (linked in the PR checks section) and unblock them. If you do not have permission to unblock, ping simon-mo or khluu to add you in our Buildkite org.

Once the PR is approved and ready to go, your PR reviewer(s) can run CI to test the changes comprehensively before merging.

To run CI, PR reviewers can either: Add ready label to the PR or enable auto-merge.

🚀

@rsshaik1 rsshaik1 marked this pull request as ready for review June 27, 2025 08:57
Copy link
Collaborator

@jeejeelee jeejeelee left a comment

Choose a reason for hiding this comment

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

QQ: Is only NF4 inference supported now?

@@ -0,0 +1,156 @@
# SPDX-License-Identifier: Apache-2.0
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
# SPDX-License-Identifier: Apache-2.0
# SPDX-License-Identifier: Apache-2.0
# SPDX-FileCopyrightText: Copyright contributors to the vLLM project

@vivekgoe
Copy link
Contributor

vivekgoe commented Jun 30, 2025

QQ: Is only NF4 inference supported now?

@jeejeelee Yes, we support only NF4 inference on Gaudi. Also, we will delete the HPU specific test file which got added to this PR by mistake (FYI @rsshaik1)

Signed-off-by: Ruheena Suhani Shaik <[email protected]>
@jeejeelee
Copy link
Collaborator

QQ: Is only NF4 inference supported now?

@jeejeelee Yes, we support only NF4 inference on Gaudi. Also, we will delete the HPU specific test file which got added to this PR by mistake (FYI @rsshaik1)

Considering that vllm now also supports load_8bit, please add a relevant log to inform users that HPU currently does not support 8-bit inference.

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