mirror of
https://github.com/ggerganov/llama.cpp.git
synced 2025-04-17 20:16:09 +00:00
267c1399f1
* (wip) refactor downloading system [no ci] * fix all examples * fix mmproj with -hf * gemma3: update readme * only handle mmproj in llava example * fix multi-shard download * windows: fix problem with std::min and std::max * fix 2
51 lines
1.0 KiB
Markdown
51 lines
1.0 KiB
Markdown
# Gemma 3 vision
|
|
|
|
> [!IMPORTANT]
|
|
>
|
|
> This is very experimental, only used for demo purpose.
|
|
|
|
## Quick started
|
|
|
|
You can use pre-quantized model from [ggml-org](https://huggingface.co/ggml-org)'s Hugging Face account
|
|
|
|
```bash
|
|
# build
|
|
cmake -B build
|
|
cmake --build build --target llama-gemma3-cli
|
|
|
|
# alternatively, install from brew (MacOS)
|
|
brew install llama.cpp
|
|
|
|
# run it
|
|
llama-gemma3-cli -hf ggml-org/gemma-3-4b-it-GGUF
|
|
llama-gemma3-cli -hf ggml-org/gemma-3-12b-it-GGUF
|
|
llama-gemma3-cli -hf ggml-org/gemma-3-27b-it-GGUF
|
|
|
|
# note: 1B model does not support vision
|
|
```
|
|
|
|
## How to get mmproj.gguf?
|
|
|
|
```bash
|
|
cd gemma-3-4b-it
|
|
python ../llama.cpp/examples/llava/gemma3_convert_encoder_to_gguf.py .
|
|
|
|
# output file is mmproj.gguf
|
|
```
|
|
|
|
## How to run it?
|
|
|
|
What you need:
|
|
- The text model GGUF, can be converted using `convert_hf_to_gguf.py`
|
|
- The mmproj file from step above
|
|
- An image file
|
|
|
|
```bash
|
|
# build
|
|
cmake -B build
|
|
cmake --build build --target llama-gemma3-cli
|
|
|
|
# run it
|
|
./build/bin/llama-gemma3-cli -m {text_model}.gguf --mmproj mmproj.gguf --image your_image.jpg
|
|
```
|