Feature Request: mmproj GPU processing while offloading weights

Đang mở
#179 2 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
20/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Ít trao đổi
Công nghệ
cpp

Hướng nghiên cứu

Start from the README and the linked llama.cpp discussion #20246, then trace how the existing --mmproj-offload and --no-mmproj-offload options are wired through the CLI and multimodal projector loading. The issue names no source files, so the first task is to locate the mmproj load/encode path and the model-specific projector implementations such as Qwen and Gemma before proposing a design. Done means a documented, working third mode that keeps image encoding on GPU without permanent full projector residency.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

enhancement
Prerequisites
  • I am running the latest code. Mention the version if possible as well.
  • I carefully followed the README.md.
  • I searched using keywords relevant to my issue to make sure that I am creating a new issue that is not already open (or closed).
  • I reviewed the Discussions, and have a new and useful enhancement to share.
Feature Description

I would like to request an option to use GPU-accelerated vision processing without keeping the complete multimodal projector permanently resident in VRAM.

Currently there are essentially two choices:

--mmproj-offload: fast GPU image encoding, but the projector permanently consumes a significant amount of VRAM.

--no-mmproj-offload: saves the VRAM, but image encoding runs on the CPU and can be considerably slower.

What I would like is a third option: keep the VRAM available for the LLM / KV cache most of the time, while still performing image encoding on the GPU.

There already seem to be several approaches demonstrating that this is possible:

https://github.com/ggml-org/llama.cpp/discussions/20246

https://github.com/Anbeeld/beellama.cpp/issues/140

https://github.com/valujin/beellama-kvarn

I also encountered a similar low-VRAM GPU vision approach while testing HyperQwen / vLLM.

Motivation

Currently, loading mmproj typically consumes around 1 GB of VRAM.

On VRAM-constrained GPUs, this is quite significant, especially when running large models with long context windows. That VRAM could otherwise be used for additional context, larger KV cache, draft models, or other features.

CPU-based image processing is an alternative, but in my experience it creates substantial overhead and is much slower.

For this reason, I currently often disable mmproj completely for Qwen and Gemma models: keeping it on the GPU costs too much VRAM, while processing images on the CPU is too expensive.

A low-memory GPU implementation would provide a useful middle ground:

  • fast GPU-based image processing

  • very low additional VRAM usage

  • more VRAM available for context and KV cache

  • no need to choose between fast vision processing and large context sizes

For users running modern multimodal models on GPUs with limited VRAM, this could make a substantial difference.

Possible Implementation

HyperQwen may provide a useful reference implementation. Its vLLM-based implementation seems to use a sliding-window approach for image processing, allowing the processing to remain GPU-accelerated while using only a very small amount of VRAM.

The related llama.cpp discussion also appears to cover approaches in this direction:

https://github.com/ggml-org/llama.cpp/discussions/20246

I assume that a fully model-independent implementation may not be straightforward, since projector architectures differ between model families.

Still, even an implementation initially targeting a few common architectures such as Qwen and Gemma could already be very useful, and might provide a basis for a more generic solution later.

Ngôn ngữ chính
C++
Star
1.2k
Fork
80
Merge trung bình
4 ngày 20 giờ
Pull request đã merge (30 ngày)
2

Chuẩn bị môi trường

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của Anbeeld/beellama.cpp

Tất cả issue của Anbeeld/beellama.cpp

Issue tương tự

Thêm issue về C++

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.