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

Kwai-Keye
/
Keye-VL-2.0-30B-A3B

Image-Text-to-Text
Transformers
Safetensors
English
KeyeVL2
feature-extraction
multimodal
conversational
custom_code
Model card Files Files and versions
xet
Community
1

Instructions to use Kwai-Keye/Keye-VL-2.0-30B-A3B with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

  • Libraries
  • Transformers

    How to use Kwai-Keye/Keye-VL-2.0-30B-A3B with Transformers:

    # Use a pipeline as a high-level helper
    from transformers import pipeline
    
    pipe = pipeline("image-text-to-text", model="Kwai-Keye/Keye-VL-2.0-30B-A3B", trust_remote_code=True)
    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 AutoModel
    model = AutoModel.from_pretrained("Kwai-Keye/Keye-VL-2.0-30B-A3B", trust_remote_code=True, dtype="auto")
  • Notebooks
  • Google Colab
  • Kaggle
  • Local Apps
  • vLLM

    How to use Kwai-Keye/Keye-VL-2.0-30B-A3B with vLLM:

    Install from pip and serve model
    # Install vLLM from pip:
    pip install vllm
    # Start the vLLM server:
    vllm serve "Kwai-Keye/Keye-VL-2.0-30B-A3B"
    # Call the server using curl (OpenAI-compatible API):
    curl -X POST "http://localhost:8000/v1/chat/completions" \
    	-H "Content-Type: application/json" \
    	--data '{
    		"model": "Kwai-Keye/Keye-VL-2.0-30B-A3B",
    		"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/Kwai-Keye/Keye-VL-2.0-30B-A3B
  • SGLang

    How to use Kwai-Keye/Keye-VL-2.0-30B-A3B 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 "Kwai-Keye/Keye-VL-2.0-30B-A3B" \
        --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": "Kwai-Keye/Keye-VL-2.0-30B-A3B",
    		"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 "Kwai-Keye/Keye-VL-2.0-30B-A3B" \
            --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": "Kwai-Keye/Keye-VL-2.0-30B-A3B",
    		"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 Kwai-Keye/Keye-VL-2.0-30B-A3B with Docker Model Runner:

    docker model run hf.co/Kwai-Keye/Keye-VL-2.0-30B-A3B
Keye-VL-2.0-30B-A3B / figures
4.75 MB
Ctrl+K
Ctrl+K
  • 1 contributor
History: 9 commits
Kwai-Keye's picture
Kwai-Keye
Fix logo visibility in dark theme
df28d5a about 2 hours ago
  • Keye-logo--black.png
    1.76 MB
    xet
    Add files using upload-large-folder tool 1 day ago
  • Keye-logo--white.png
    1.67 MB
    xet
    Fix logo visibility in dark theme about 2 hours ago
  • all_metric.png
    1.04 MB
    xet
    Upload all_metric.png 1 day ago
  • video_fig.png
    278 kB
    xet
    Add files using upload-large-folder tool 1 day ago