Image-Text-to-Text
MLX
English
apple-silicon
Mixture of Experts
mixture-of-experts
vision-language
gemma
falcon-perception
inference
Instructions to use waltgrace/mlx-expert-sniper with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use waltgrace/mlx-expert-sniper with MLX:
# Make sure mlx-vlm is installed # pip install --upgrade mlx-vlm from mlx_vlm import load, generate from mlx_vlm.prompt_utils import apply_chat_template from mlx_vlm.utils import load_config # Load the model model, processor = load("waltgrace/mlx-expert-sniper") config = load_config("waltgrace/mlx-expert-sniper") # Prepare input image = ["http://images.cocodataset.org/val2017/000000039769.jpg"] prompt = "Describe this image." # Apply chat template formatted_prompt = apply_chat_template( processor, config, prompt, num_images=1 ) # Generate output output = generate(model, processor, formatted_prompt, image) print(output) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- LM Studio
- Atomic Chat
Download stream_preprocess_coder.py from waltgrace/mlx-expert-sniper: direct link, hf CLI and curl.
- Browser
- Download file 6.87 kB
-
https://huggingface.co/waltgrace/mlx-expert-sniper/resolve/main/stream_preprocess_coder.py
- Command line
-
hf download hf://waltgrace/mlx-expert-sniper/stream_preprocess_coder.py
-
curl -L -o stream_preprocess_coder.py https://huggingface.co/waltgrace/mlx-expert-sniper/resolve/main/stream_preprocess_coder.py
6.87 kB
| #!/usr/bin/env python3 | |
| """Stream-preprocess Qwen3-Coder-30B-A3B-4bit.""" | |
| import os, sys, json, time, gc, shutil, glob | |
| sys.path.insert(0, os.path.join(os.path.dirname(__file__), "src")) | |
| import numpy as np | |
| import mlx.core as mx | |
| REPO = "mlx-community/Qwen3-Coder-30B-A3B-Instruct-4bit" | |
| OUTPUT_DIR = os.path.expanduser("~/models/qwen3-coder-30b") | |
| PAGE_SIZE = 16384 | |
| TENSOR_NAMES = [ | |
| "gate_proj.weight", "gate_proj.scales", "gate_proj.biases", | |
| "up_proj.weight", "up_proj.scales", "up_proj.biases", | |
| "down_proj.weight", "down_proj.scales", "down_proj.biases", | |
| ] | |
| def convert_layer_to_bin(layer_data, layer_idx, num_experts, output_dir): | |
| tensor_info = {} | |
| expert_block_size = 0 | |
| for name in TENSOR_NAMES: | |
| t = layer_data[name] | |
| per_expert_shape = list(t.shape[1:]) | |
| elem_size = 4 if t.dtype == mx.uint32 else (2 if t.dtype in (mx.bfloat16, mx.float16) else 4) | |
| nbytes = 1 | |
| for s in per_expert_shape: | |
| nbytes *= s | |
| nbytes *= elem_size | |
| tensor_info[name] = { | |
| "shape_per_expert": per_expert_shape, | |
| "dtype": str(t.dtype).replace("mlx.core.", ""), | |
| "nbytes": nbytes, | |
| "inner_offset": expert_block_size, | |
| } | |
| expert_block_size += nbytes | |
| header = { | |
| "layer_idx": layer_idx, "num_experts": num_experts, | |
| "layout": {"expert_block_size": expert_block_size, "data_start": PAGE_SIZE, "tensors": tensor_info} | |
| } | |
| header_bytes = json.dumps(header, indent=2).encode() | |
| assert len(header_bytes) < PAGE_SIZE | |
| header_bytes += b"\x00" * (PAGE_SIZE - len(header_bytes)) | |
| out_path = os.path.join(output_dir, "bin", f"moe_layer_{layer_idx:02d}.bin") | |
| with open(out_path, "wb") as f: | |
| f.write(header_bytes) | |
| for expert_id in range(num_experts): | |
| for name in TENSOR_NAMES: | |
| t = layer_data[name][expert_id] | |
| if t.dtype == mx.bfloat16: | |
| raw = np.array(t.astype(mx.float16)).astype(np.float16).tobytes() | |
| elif t.dtype == mx.uint32: | |
| raw = np.array(t).astype(np.uint32).tobytes() | |
| else: | |
| raw = np.array(t).tobytes() | |
| f.write(raw) | |
| return os.path.getsize(out_path) | |
| def main(): | |
| from huggingface_hub import hf_hub_download | |
| print("=" * 55) | |
| print(f" Stream Preprocess: {REPO.split('/')[-1]}") | |
| print(f" Output: {OUTPUT_DIR}") | |
| print("=" * 55) | |
| os.makedirs(os.path.join(OUTPUT_DIR, "bin"), exist_ok=True) | |
| for fname in ["config.json", "tokenizer.json", "tokenizer_config.json", "special_tokens_map.json"]: | |
| try: | |
| path = hf_hub_download(REPO, fname, local_dir="/tmp/sniper_dl_coder") | |
| shutil.copy(path, os.path.join(OUTPUT_DIR, fname)) | |
| print(f" Downloaded {fname}") | |
| except Exception as e: | |
| print(f" Skipped {fname}: {e}") | |
| with open(os.path.join(OUTPUT_DIR, "config.json")) as f: | |
| config = json.load(f) | |
| num_layers = config.get("num_hidden_layers", 48) | |
| print(f" Layers: {num_layers}, Experts: {config.get('num_experts', 0)}") | |
| idx_path = hf_hub_download(REPO, "model.safetensors.index.json", local_dir="/tmp/sniper_dl_coder") | |
| with open(idx_path) as f: | |
| idx = json.load(f) | |
| shards = sorted(set(idx["weight_map"].values())) | |
| print(f" {len(shards)} shards") | |
| existing = set() | |
| for f in os.listdir(os.path.join(OUTPUT_DIR, "bin")): | |
| if f.startswith("moe_layer_") and f.endswith(".bin"): | |
| existing.add(int(f.split("_")[2].split(".")[0])) | |
| pinned = {} | |
| layers_done = set(existing) | |
| partial_layers = {} | |
| for si, shard_name in enumerate(shards): | |
| print(f"\n [{si+1}/{len(shards)}] Downloading {shard_name}...") | |
| t0 = time.time() | |
| shard_path = hf_hub_download(REPO, shard_name, local_dir="/tmp/sniper_dl_coder") | |
| shard_size = os.path.getsize(shard_path) / 1e9 | |
| print(f" {shard_size:.1f} GB in {time.time()-t0:.0f}s") | |
| data = mx.load(shard_path) | |
| print(f" {len(data)} tensors") | |
| layer_experts = {} | |
| for key, tensor in data.items(): | |
| if "switch_mlp" in key: | |
| layer = int(key.split(".layers.")[1].split(".")[0]) | |
| short = key.split(".switch_mlp.")[1] | |
| layer_experts.setdefault(layer, {})[short] = tensor | |
| else: | |
| pinned[key] = tensor | |
| for layer_idx, tensors in layer_experts.items(): | |
| if layer_idx in layers_done: | |
| continue | |
| if layer_idx in partial_layers: | |
| partial_layers[layer_idx].update(tensors) | |
| tensors = partial_layers[layer_idx] | |
| if len(tensors) < 9: | |
| partial_layers[layer_idx] = tensors | |
| print(f" Layer {layer_idx}: partial ({len(tensors)}/9)") | |
| continue | |
| num_experts = tensors[list(tensors.keys())[0]].shape[0] | |
| sz = convert_layer_to_bin(tensors, layer_idx, num_experts, OUTPUT_DIR) | |
| layers_done.add(layer_idx) | |
| if layer_idx in partial_layers: | |
| del partial_layers[layer_idx] | |
| print(f" Layer {layer_idx}: {sz/1e6:.0f} MB") | |
| del data, layer_experts | |
| gc.collect(); mx.clear_cache() | |
| try: | |
| os.remove(shard_path) | |
| print(f" Deleted shard ({shard_size:.1f} GB freed)") | |
| except: | |
| pass | |
| # Merge partials | |
| for layer_idx, tensors in partial_layers.items(): | |
| if layer_idx in layers_done or len(tensors) < 9: | |
| continue | |
| num_experts = tensors[list(tensors.keys())[0]].shape[0] | |
| sz = convert_layer_to_bin(tensors, layer_idx, num_experts, OUTPUT_DIR) | |
| layers_done.add(layer_idx) | |
| print(f" Layer {layer_idx}: {sz/1e6:.0f} MB (merged)") | |
| if pinned: | |
| print(f"\n Saving pinned ({len(pinned)} tensors)...") | |
| mx.save_safetensors(os.path.join(OUTPUT_DIR, "pinned.safetensors"), pinned) | |
| psz = os.path.getsize(os.path.join(OUTPUT_DIR, "pinned.safetensors")) / 1e9 | |
| print(f" Pinned: {psz:.2f} GB") | |
| else: | |
| psz = 0 | |
| shutil.rmtree("/tmp/sniper_dl_coder", ignore_errors=True) | |
| bin_files = sorted(glob.glob(os.path.join(OUTPUT_DIR, "bin", "moe_layer_*.bin"))) | |
| total = sum(os.path.getsize(f) for f in bin_files) | |
| missing = set(range(num_layers)) - layers_done | |
| print(f"\n Expert layers: {len(bin_files)}/{num_layers}") | |
| print(f" Expert total: {total/1e9:.2f} GB") | |
| print(f" Pinned: {psz:.2f} GB") | |
| if missing: | |
| print(f" WARNING: Missing layers: {sorted(missing)}") | |
| else: | |
| print(f"\n All {num_layers} layers converted!") | |
| print(f" Test: mlx-sniper run {OUTPUT_DIR} -p 'Write a Python quicksort' -v") | |
| if __name__ == "__main__": | |
| main() | |