Instructions to use SAIFIINDUSTRIES/deepseek-v4-pro with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use SAIFIINDUSTRIES/deepseek-v4-pro with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="SAIFIINDUSTRIES/deepseek-v4-pro")# Load model directly from transformers import AutoTokenizer, AutoModelForCausalLM tokenizer = AutoTokenizer.from_pretrained("SAIFIINDUSTRIES/deepseek-v4-pro") model = AutoModelForCausalLM.from_pretrained("SAIFIINDUSTRIES/deepseek-v4-pro", device_map="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use SAIFIINDUSTRIES/deepseek-v4-pro with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "SAIFIINDUSTRIES/deepseek-v4-pro" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "SAIFIINDUSTRIES/deepseek-v4-pro", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker
docker model run hf.co/SAIFIINDUSTRIES/deepseek-v4-pro
- SGLang
How to use SAIFIINDUSTRIES/deepseek-v4-pro 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 "SAIFIINDUSTRIES/deepseek-v4-pro" \ --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": "SAIFIINDUSTRIES/deepseek-v4-pro", "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 "SAIFIINDUSTRIES/deepseek-v4-pro" \ --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": "SAIFIINDUSTRIES/deepseek-v4-pro", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }' - Docker Model Runner
How to use SAIFIINDUSTRIES/deepseek-v4-pro with Docker Model Runner:
docker model run hf.co/SAIFIINDUSTRIES/deepseek-v4-pro
Upload inference/convert.py with huggingface_hub
Browse files- inference/convert.py +168 -0
inference/convert.py
ADDED
|
@@ -0,0 +1,168 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
import os
|
| 2 |
+
import shutil
|
| 3 |
+
from argparse import ArgumentParser
|
| 4 |
+
from glob import glob
|
| 5 |
+
from tqdm import tqdm, trange
|
| 6 |
+
|
| 7 |
+
import torch
|
| 8 |
+
from safetensors.torch import safe_open, save_file
|
| 9 |
+
|
| 10 |
+
|
| 11 |
+
FP4_TABLE = torch.tensor([
|
| 12 |
+
0.0, 0.5, 1.0, 1.5, 2.0, 3.0, 4.0, 6.0,
|
| 13 |
+
0.0, -0.5, -1.0, -1.5, -2.0, -3.0, -4.0, -6.0
|
| 14 |
+
], dtype=torch.float32)
|
| 15 |
+
|
| 16 |
+
|
| 17 |
+
def cast_e2m1fn_to_e4m3fn(x: torch.Tensor, scale: torch.Tensor) -> tuple[torch.Tensor, torch.Tensor]:
|
| 18 |
+
"""
|
| 19 |
+
Casts a tensor from e2m1fn to e4m3fn losslessly.
|
| 20 |
+
"""
|
| 21 |
+
assert x.dtype == torch.int8
|
| 22 |
+
assert x.ndim == 2
|
| 23 |
+
out_dim, in_dim = x.size()
|
| 24 |
+
in_dim *= 2
|
| 25 |
+
fp8_block_size = 128
|
| 26 |
+
fp4_block_size = 32
|
| 27 |
+
assert in_dim % fp8_block_size == 0 and out_dim % fp8_block_size == 0
|
| 28 |
+
assert scale.size(0) == out_dim and scale.size(1) == in_dim // fp4_block_size
|
| 29 |
+
|
| 30 |
+
x = x.view(torch.uint8)
|
| 31 |
+
low = x & 0x0F
|
| 32 |
+
high = (x >> 4) & 0x0F
|
| 33 |
+
x = torch.stack([FP4_TABLE[low.long()], FP4_TABLE[high.long()]], dim=-1).flatten(2)
|
| 34 |
+
|
| 35 |
+
# max_fp4 (6.0) * MAX_OFFSET must fit in e4m3fn (max 448)
|
| 36 |
+
# 6.0 * 2^6 = 384 < 448; 6.0 * 2^7 = 768 > 448; so MAX_OFFSET_BITS = 6
|
| 37 |
+
MAX_OFFSET_BITS = 6
|
| 38 |
+
|
| 39 |
+
bOut = out_dim // fp8_block_size
|
| 40 |
+
bIn = in_dim // fp8_block_size
|
| 41 |
+
# bOut, bIn, 128, 128
|
| 42 |
+
x = x.view(bOut, fp8_block_size, bIn, fp8_block_size).transpose(1, 2)
|
| 43 |
+
# bOut, bIn, 128*4
|
| 44 |
+
scale = scale.float().view(bOut, fp8_block_size, bIn, -1).transpose(1, 2).flatten(2)
|
| 45 |
+
## bOut, bIn, 1
|
| 46 |
+
scale_max_offset_bits = scale.amax(dim=-1, keepdim=True) / (2**MAX_OFFSET_BITS)
|
| 47 |
+
# bOut, bIn, 128*4
|
| 48 |
+
offset = scale / scale_max_offset_bits
|
| 49 |
+
# bOut, bIn, 128, 128
|
| 50 |
+
offset = offset.unflatten(-1, (fp8_block_size, -1)).repeat_interleave(fp4_block_size, dim=-1)
|
| 51 |
+
x = (x * offset).transpose(1, 2).reshape(out_dim, in_dim)
|
| 52 |
+
return x.to(torch.float8_e4m3fn), scale_max_offset_bits.squeeze(-1).to(torch.float8_e8m0fnu)
|
| 53 |
+
|
| 54 |
+
|
| 55 |
+
mapping = {
|
| 56 |
+
"embed_tokens": ("embed", 0),
|
| 57 |
+
"input_layernorm": ("attn_norm", None),
|
| 58 |
+
"post_attention_layernorm": ("ffn_norm", None),
|
| 59 |
+
"q_proj": ("wq", 0),
|
| 60 |
+
"q_a_proj": ("wq_a", None),
|
| 61 |
+
"q_a_layernorm": ("q_norm", None),
|
| 62 |
+
"q_b_proj": ("wq_b", 0),
|
| 63 |
+
"kv_a_proj_with_mqa": ("wkv_a", None),
|
| 64 |
+
"kv_a_layernorm": ("kv_norm", None),
|
| 65 |
+
"kv_b_proj": ("wkv_b", 0),
|
| 66 |
+
"o_proj": ("wo", 1),
|
| 67 |
+
"gate_proj": ("w1", 0),
|
| 68 |
+
"down_proj": ("w2", 1),
|
| 69 |
+
"up_proj": ("w3", 0),
|
| 70 |
+
"lm_head": ("head", 0),
|
| 71 |
+
|
| 72 |
+
"embed": ("embed", 0),
|
| 73 |
+
"wq_b": ("wq_b", 0),
|
| 74 |
+
"wo_a": ("wo_a", 0),
|
| 75 |
+
"wo_b": ("wo_b", 1),
|
| 76 |
+
"head": ("head", 0),
|
| 77 |
+
"attn_sink": ("attn_sink", 0),
|
| 78 |
+
"weights_proj": ("weights_proj", 0),
|
| 79 |
+
}
|
| 80 |
+
|
| 81 |
+
|
| 82 |
+
def main(hf_ckpt_path, save_path, n_experts, mp, expert_dtype):
|
| 83 |
+
"""
|
| 84 |
+
Converts and saves model checkpoint files into a specified format.
|
| 85 |
+
|
| 86 |
+
Args:
|
| 87 |
+
hf_ckpt_path (str): Path to the directory containing the input checkpoint files.
|
| 88 |
+
save_path (str): Path to the directory where the converted checkpoint files will be saved.
|
| 89 |
+
n_experts (int): Total number of experts in the model.
|
| 90 |
+
mp (int): Model parallelism factor.
|
| 91 |
+
|
| 92 |
+
Returns:
|
| 93 |
+
None
|
| 94 |
+
"""
|
| 95 |
+
torch.set_num_threads(8)
|
| 96 |
+
n_local_experts = n_experts // mp
|
| 97 |
+
state_dicts = [{} for _ in range(mp)]
|
| 98 |
+
|
| 99 |
+
for file_path in tqdm(glob(os.path.join(hf_ckpt_path, "*.safetensors"))):
|
| 100 |
+
with safe_open(file_path, framework="pt", device="cpu") as f:
|
| 101 |
+
for name in f.keys():
|
| 102 |
+
param: torch.Tensor = f.get_tensor(name)
|
| 103 |
+
if name.startswith("model."):
|
| 104 |
+
name = name[len("model."):]
|
| 105 |
+
if name.startswith("mtp.") and ("emb" in name or name.endswith("head.weight")):
|
| 106 |
+
continue
|
| 107 |
+
name = name.replace("self_attn", "attn")
|
| 108 |
+
name = name.replace("mlp", "ffn")
|
| 109 |
+
name = name.replace("weight_scale_inv", "scale")
|
| 110 |
+
name = name.replace("e_score_correction_bias", "bias")
|
| 111 |
+
if any(x in name for x in ["hc", "attn_sink", "tie2eid", "ape"]): # without .weight
|
| 112 |
+
key = name.split(".")[-1]
|
| 113 |
+
else:
|
| 114 |
+
key = name.split(".")[-2]
|
| 115 |
+
if key in mapping:
|
| 116 |
+
new_key, dim = mapping[key]
|
| 117 |
+
else:
|
| 118 |
+
new_key, dim = key, None
|
| 119 |
+
name = name.replace(key, new_key)
|
| 120 |
+
for i in range(mp):
|
| 121 |
+
new_param = param
|
| 122 |
+
if "experts" in name and "shared_experts" not in name:
|
| 123 |
+
idx = int(name.split(".")[-3])
|
| 124 |
+
if idx < i * n_local_experts or idx >= (i + 1) * n_local_experts:
|
| 125 |
+
continue
|
| 126 |
+
elif dim is not None:
|
| 127 |
+
assert param.size(dim) % mp == 0, f"Dimension {dim} must be divisible by {mp}"
|
| 128 |
+
shard_size = param.size(dim) // mp
|
| 129 |
+
new_param = param.narrow(dim, i * shard_size, shard_size).contiguous()
|
| 130 |
+
state_dicts[i][name] = new_param
|
| 131 |
+
|
| 132 |
+
os.makedirs(save_path, exist_ok=True)
|
| 133 |
+
|
| 134 |
+
for i in trange(mp):
|
| 135 |
+
names = list(state_dicts[i].keys())
|
| 136 |
+
for name in names:
|
| 137 |
+
if name.endswith("wo_a.weight"):
|
| 138 |
+
weight = state_dicts[i][name]
|
| 139 |
+
scale = state_dicts[i].pop(name.replace("weight", "scale"))
|
| 140 |
+
weight = weight.unflatten(0, (-1, 128)).unflatten(-1, (-1, 128)).float() * scale[:, None, :, None].float()
|
| 141 |
+
state_dicts[i][name] = weight.flatten(2, 3).flatten(0, 1).bfloat16()
|
| 142 |
+
elif "experts" in name and state_dicts[i][name].dtype == torch.int8:
|
| 143 |
+
if expert_dtype == "fp8":
|
| 144 |
+
scale_name = name.replace("weight", "scale")
|
| 145 |
+
weight = state_dicts[i].pop(name)
|
| 146 |
+
scale = state_dicts[i].pop(scale_name)
|
| 147 |
+
state_dicts[i][name], state_dicts[i][scale_name] = cast_e2m1fn_to_e4m3fn(weight, scale)
|
| 148 |
+
else:
|
| 149 |
+
state_dicts[i][name] = state_dicts[i][name].view(torch.float4_e2m1fn_x2)
|
| 150 |
+
save_file(state_dicts[i], os.path.join(save_path, f"model{i}-mp{mp}.safetensors"))
|
| 151 |
+
|
| 152 |
+
for file in ["tokenizer.json", "tokenizer_config.json"]:
|
| 153 |
+
old_file_path = os.path.join(hf_ckpt_path, file)
|
| 154 |
+
new_file_path = os.path.join(save_path, file)
|
| 155 |
+
if os.path.exists(old_file_path):
|
| 156 |
+
shutil.copyfile(old_file_path, new_file_path)
|
| 157 |
+
|
| 158 |
+
|
| 159 |
+
if __name__ == "__main__":
|
| 160 |
+
parser = ArgumentParser()
|
| 161 |
+
parser.add_argument("--hf-ckpt-path", type=str, required=True)
|
| 162 |
+
parser.add_argument("--save-path", type=str, required=True)
|
| 163 |
+
parser.add_argument("--n-experts", type=int, required=True)
|
| 164 |
+
parser.add_argument("--model-parallel", type=int, required=True)
|
| 165 |
+
parser.add_argument("--expert-dtype", type=str, choices=["fp8", "fp4"], required=False, default=None)
|
| 166 |
+
args = parser.parse_args()
|
| 167 |
+
assert args.n_experts % args.model_parallel == 0, "Number of experts must be divisible by model parallelism"
|
| 168 |
+
main(args.hf_ckpt_path, args.save_path, args.n_experts, args.model_parallel, args.expert_dtype)
|