Instructions to use moonshotai/Kimi-VL-A3B-Thinking-2506 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use moonshotai/Kimi-VL-A3B-Thinking-2506 with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("image-text-to-text", model="moonshotai/Kimi-VL-A3B-Thinking-2506", 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("moonshotai/Kimi-VL-A3B-Thinking-2506", trust_remote_code=True, dtype="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use moonshotai/Kimi-VL-A3B-Thinking-2506 with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "moonshotai/Kimi-VL-A3B-Thinking-2506" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "moonshotai/Kimi-VL-A3B-Thinking-2506", "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/moonshotai/Kimi-VL-A3B-Thinking-2506
- SGLang
How to use moonshotai/Kimi-VL-A3B-Thinking-2506 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 "moonshotai/Kimi-VL-A3B-Thinking-2506" \ --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": "moonshotai/Kimi-VL-A3B-Thinking-2506", "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 "moonshotai/Kimi-VL-A3B-Thinking-2506" \ --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": "moonshotai/Kimi-VL-A3B-Thinking-2506", "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 moonshotai/Kimi-VL-A3B-Thinking-2506 with Docker Model Runner:
docker model run hf.co/moonshotai/Kimi-VL-A3B-Thinking-2506
Are there any quantization models, such as GGUF? Can it run with 16GB of VRAM?
Are there any quantization models, such as GGUF? Can it run with 16GB of VRAM?
ChatLLM.cpp supports it (at least it's listed β I haven't tested it myself).
Llama.cpp still doesn't support this model.
And yes, youβll need around 11β12 GB of VRAM to run the model in Q4 without context.
Also, there are no quants available yet, so youβll have to quant it yourself (or use vLLM in 4-bit mode).
You don't need that much vram for moe models. I can run qwen3-30b-a3b q4 in 8G vram.
Is it true that you can fit active experts into 8 GB VRAM and offload the rest to the CPU.
But the speed decreases proportionally depending on the RAM speed.
Also, vLLM doesn't support offloading to the CPU (if I'm wrong, I'd be happy to learn).
And I haven't checked whether chatllm.cpp supports it either (my mistake β I should have at least quickly verified).
Is it true that you can fit active experts into 8 GB VRAM and offload the rest to the CPU.
But the speed decreases proportionally depending on the RAM speed.
Also, vLLM doesn't support offloading to the CPU (if I'm wrong, I'd be happy to learn).
And I haven't checked whether chatllm.cpp supports it either (my mistake β I should have at least quickly verified).
Yes, the speed will decrease if you offload to ram, but it's not nearly as severe as offloading dense models.
I tried 32b model and it is unusable for 8G vram.
And I only tried on latest llama.cpp, so can't speak for other frameworks.