Document Maple sampler and context settings

README.md

@@ -31,6 +31,22 @@ This repository contains an enhanced mixed-precision oQ4e MLX quantization of [`
 
 This is an MLX conversion for local inference on Apple Silicon. Please follow the base model's MIT license and usage terms.
 
+## Recommended generation settings
+
+Maple is a reasoning-heavy model and may spend a substantial part of its response budget thinking. For the OpenAI-compatible API or oMLX UI, start with:
+
+```text
+temperature:         1.0
+top_p:               0.95
+top_k:               40
+min_p:               0.05
+repetition_penalty:  1.0
+max_tokens:          8192 or higher
+max context:         131072 tokens (native model limit)
+```
+
+These sampler values match DeepGrove's Maple `llama.cpp` setup. The model declares a native 131,072-token context window and does not require RoPE/YARN scaling for that window. Actual usable context may be lower on systems constrained by KV-cache memory; do not assume that extending beyond 131,072 tokens is supported.
+
 ---
 
 ## Base model description