Hugging Face's logo Hugging Face
  • Models
  • Datasets
  • Spaces
  • Buckets new
  • Docs
  • Enterprise
  • Pricing
    • Website
      • Tasks
      • HuggingChat
      • Collections
      • Languages
      • Organizations
    • Community
      • Blog
      • Posts
      • Daily Papers
      • Learn
      • Discord
      • Forum
      • GitHub
    • Solutions
      • Team & Enterprise
      • Hugging Face PRO
      • Enterprise Support
      • Inference Providers
      • Inference Endpoints
      • Storage Buckets

  • Log In
  • Sign Up

JohnCheng
/
gemma-3-4b-it-csv2

Image-Text-to-Text
Transformers
Safetensors
gemma3
conversational
text-generation-inference
Model card Files Files and versions
xet
Community

Instructions to use JohnCheng/gemma-3-4b-it-csv2 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

  • Libraries
  • Transformers

    How to use JohnCheng/gemma-3-4b-it-csv2 with Transformers:

    # Use a pipeline as a high-level helper
    from transformers import pipeline
    
    pipe = pipeline("image-text-to-text", model="JohnCheng/gemma-3-4b-it-csv2")
    messages = [
        {
            "role": "user",
            "content": [
                {"type": "image", "url": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/p-blog/candy.JPG"},
                {"type": "text", "text": "What animal is on the candy?"}
            ]
        },
    ]
    pipe(text=messages)
    # Load model directly
    from transformers import AutoProcessor, AutoModelForImageTextToText
    
    processor = AutoProcessor.from_pretrained("JohnCheng/gemma-3-4b-it-csv2")
    model = AutoModelForImageTextToText.from_pretrained("JohnCheng/gemma-3-4b-it-csv2")
    messages = [
        {
            "role": "user",
            "content": [
                {"type": "image", "url": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/p-blog/candy.JPG"},
                {"type": "text", "text": "What animal is on the candy?"}
            ]
        },
    ]
    inputs = processor.apply_chat_template(
    	messages,
    	add_generation_prompt=True,
    	tokenize=True,
    	return_dict=True,
    	return_tensors="pt",
    ).to(model.device)
    
    outputs = model.generate(**inputs, max_new_tokens=40)
    print(processor.decode(outputs[0][inputs["input_ids"].shape[-1]:]))
  • Notebooks
  • Google Colab
  • Kaggle
  • Local Apps
  • vLLM

    How to use JohnCheng/gemma-3-4b-it-csv2 with vLLM:

    Install from pip and serve model
    # Install vLLM from pip:
    pip install vllm
    # Start the vLLM server:
    vllm serve "JohnCheng/gemma-3-4b-it-csv2"
    # Call the server using curl (OpenAI-compatible API):
    curl -X POST "http://localhost:8000/v1/chat/completions" \
    	-H "Content-Type: application/json" \
    	--data '{
    		"model": "JohnCheng/gemma-3-4b-it-csv2",
    		"messages": [
    			{
    				"role": "user",
    				"content": [
    					{
    						"type": "text",
    						"text": "Describe this image in one sentence."
    					},
    					{
    						"type": "image_url",
    						"image_url": {
    							"url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg"
    						}
    					}
    				]
    			}
    		]
    	}'
    Use Docker
    docker model run hf.co/JohnCheng/gemma-3-4b-it-csv2
  • SGLang

    How to use JohnCheng/gemma-3-4b-it-csv2 with SGLang:

    Install from pip and serve model
    # Install SGLang from pip:
    pip install sglang
    # Start the SGLang server:
    python3 -m sglang.launch_server \
        --model-path "JohnCheng/gemma-3-4b-it-csv2" \
        --host 0.0.0.0 \
        --port 30000
    # Call the server using curl (OpenAI-compatible API):
    curl -X POST "http://localhost:30000/v1/chat/completions" \
    	-H "Content-Type: application/json" \
    	--data '{
    		"model": "JohnCheng/gemma-3-4b-it-csv2",
    		"messages": [
    			{
    				"role": "user",
    				"content": [
    					{
    						"type": "text",
    						"text": "Describe this image in one sentence."
    					},
    					{
    						"type": "image_url",
    						"image_url": {
    							"url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg"
    						}
    					}
    				]
    			}
    		]
    	}'
    Use Docker images
    docker run --gpus all \
        --shm-size 32g \
        -p 30000:30000 \
        -v ~/.cache/huggingface:/root/.cache/huggingface \
        --env "HF_TOKEN=<secret>" \
        --ipc=host \
        lmsysorg/sglang:latest \
        python3 -m sglang.launch_server \
            --model-path "JohnCheng/gemma-3-4b-it-csv2" \
            --host 0.0.0.0 \
            --port 30000
    # Call the server using curl (OpenAI-compatible API):
    curl -X POST "http://localhost:30000/v1/chat/completions" \
    	-H "Content-Type: application/json" \
    	--data '{
    		"model": "JohnCheng/gemma-3-4b-it-csv2",
    		"messages": [
    			{
    				"role": "user",
    				"content": [
    					{
    						"type": "text",
    						"text": "Describe this image in one sentence."
    					},
    					{
    						"type": "image_url",
    						"image_url": {
    							"url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg"
    						}
    					}
    				]
    			}
    		]
    	}'
  • Docker Model Runner

    How to use JohnCheng/gemma-3-4b-it-csv2 with Docker Model Runner:

    docker model run hf.co/JohnCheng/gemma-3-4b-it-csv2

You need to agree to share your contact information to access this model

This repository is publicly accessible, but you have to accept the conditions to access its files and content.

Log in or Sign Up to review the conditions and access this model content.

Gated model
You can list files but not access them

Preview of files found in this repository
  • .gitattributes
    1.57 kB
    Upload tokenizer 8 months ago
  • README.md
    5.17 kB
    Upload Gemma3ForConditionalGeneration 8 months ago
  • chat_template.json
    1.62 kB
    Upload processor 8 months ago
  • config.json
    1.61 kB
    Upload Gemma3ForConditionalGeneration 8 months ago
  • generation_config.json
    210 Bytes
    Upload Gemma3ForConditionalGeneration 8 months ago
  • model-00001-of-00002.safetensors
    4.96 GB
    xet
    Upload Gemma3ForConditionalGeneration 8 months ago
  • model-00002-of-00002.safetensors
    3.64 GB
    xet
    Upload Gemma3ForConditionalGeneration 8 months ago
  • model.safetensors.index.json
    90.6 kB
    Upload Gemma3ForConditionalGeneration 8 months ago
  • preprocessor_config.json
    570 Bytes
    Upload processor 8 months ago
  • processor_config.json
    70 Bytes
    Upload processor 8 months ago
  • special_tokens_map.json
    662 Bytes
    Upload tokenizer 8 months ago
  • tokenizer.json
    33.4 MB
    xet
    Upload tokenizer 8 months ago
  • tokenizer_config.json
    1.16 MB
    Upload tokenizer 8 months ago