Image-Text-to-Text
Transformers
Safetensors
gsq
gumbel-softmax
quantization
ptq
Mixture of Experts
kimi
vllm
humming
Instructions to use ISTA-DASLab/Kimi-K2.5-2Bit-GSQ with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use ISTA-DASLab/Kimi-K2.5-2Bit-GSQ with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("image-text-to-text", model="ISTA-DASLab/Kimi-K2.5-2Bit-GSQ")# Load model directly from transformers import AutoModel model = AutoModel.from_pretrained("ISTA-DASLab/Kimi-K2.5-2Bit-GSQ", device_map="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use ISTA-DASLab/Kimi-K2.5-2Bit-GSQ with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "ISTA-DASLab/Kimi-K2.5-2Bit-GSQ" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "ISTA-DASLab/Kimi-K2.5-2Bit-GSQ", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker
docker model run hf.co/ISTA-DASLab/Kimi-K2.5-2Bit-GSQ
- SGLang
How to use ISTA-DASLab/Kimi-K2.5-2Bit-GSQ 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 "ISTA-DASLab/Kimi-K2.5-2Bit-GSQ" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "ISTA-DASLab/Kimi-K2.5-2Bit-GSQ", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'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 "ISTA-DASLab/Kimi-K2.5-2Bit-GSQ" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "ISTA-DASLab/Kimi-K2.5-2Bit-GSQ", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }' - Docker Model Runner
How to use ISTA-DASLab/Kimi-K2.5-2Bit-GSQ with Docker Model Runner:
docker model run hf.co/ISTA-DASLab/Kimi-K2.5-2Bit-GSQ
Update README.md
Browse files
README.md
CHANGED
|
@@ -96,37 +96,6 @@ humming-kernels`). See **Serving with vLLM** below.
|
|
| 96 |
|
| 97 |
## Serving with vLLM
|
| 98 |
|
| 99 |
-
> **Temporary vLLM compatibility note:** the upstream vLLM Humming MoE
|
| 100 |
-
> implementation currently has a bug that prevents this checkpoint from being
|
| 101 |
-
> served correctly. Until the fix is available upstream, use one of the
|
| 102 |
-
> following workarounds:
|
| 103 |
-
>
|
| 104 |
-
> 1. Build vLLM from our fork:
|
| 105 |
-
>
|
| 106 |
-
> ```bash
|
| 107 |
-
> git clone https://github.com/adotdad/vllm.git
|
| 108 |
-
> cd vllm
|
| 109 |
-
> pip install -e .
|
| 110 |
-
> ```
|
| 111 |
-
>
|
| 112 |
-
> 2. Or patch your existing vLLM installation by replacing:
|
| 113 |
-
>
|
| 114 |
-
> ```text
|
| 115 |
-
> vllm/model_executor/layers/quantization/humming.py
|
| 116 |
-
> ```
|
| 117 |
-
>
|
| 118 |
-
> with the version from our fork:
|
| 119 |
-
>
|
| 120 |
-
> ```text
|
| 121 |
-
> https://github.com/adotdad/vllm
|
| 122 |
-
> ```
|
| 123 |
-
|
| 124 |
-
Install the Humming kernels (required for vLLM to load this checkpoint):
|
| 125 |
-
|
| 126 |
-
```bash
|
| 127 |
-
pip install humming-kernels
|
| 128 |
-
```
|
| 129 |
-
|
| 130 |
Hopper (sm_90) or Ampere (sm ≥ 80) GPUs required for serving. On 8× H100/H200,
|
| 131 |
valid TP sizes are `1, 2, 4, 8` (Marlin MoE constraint with group size 128).
|
| 132 |
|
|
|
|
| 96 |
|
| 97 |
## Serving with vLLM
|
| 98 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 99 |
Hopper (sm_90) or Ampere (sm ≥ 80) GPUs required for serving. On 8× H100/H200,
|
| 100 |
valid TP sizes are `1, 2, 4, 8` (Marlin MoE constraint with group size 128).
|
| 101 |
|