Update README.md

README.md

@@ -9,3 +9,37 @@ base_model: zai-org/GLM-5.1
 tags:
 - mlx
 ---
+
+[GLM 5.1](https://huggingface.co/zai-org/GLM-5.1) optimized for MLX.
+
+# Usage
+
+```sh
+# Start server at http://localhost:8080/chat/completions
+uvx --from mlx-lm mlx_vlm.server \
+  --host 127.0.0.1 \
+  --port 8080 \
+  --model spicyneuron/GLM-5.1-MLX-2.9bit
+```
+
+# Methodology
+
+Quantized using a custom script inspired by Unsloth/AesSedai/ubergarm style mixed-precision GGUFs.
+MLX quantization options differ than llama.cpp, but the principles are the same:
+
+- Sensitive layers like MoE routing, attention, and output embeddings get higher precision
+- More tolerant layers like MoE experts get lower precision
+
+# Benchmarks
+
+(WIP)
+
+Tested with:
+
+```
+mlx_lm.perplexity --sequence-length 2048 --seed 123
+mlx_lm.benchmark --prompt-tokens 1024 --generation-tokens 512 --num-trials 5
+mlx_lm.evaluate --tasks hellaswag --seed 123 --num-shots 0 --limit 2000
+mlx_lm.evaluate --tasks piqa --seed 123 --num-shots 0 --limit 2000
+mlx_lm.evaluate --tasks winogrande --seed 123 --num-shots 0 --limit 2000
+```