havenoammo commited on
Commit
a529a17
·
verified ·
1 Parent(s): 44ce525

Upload README.md with huggingface_hub

Browse files
Files changed (1) hide show
  1. README.md +39 -2
README.md CHANGED
@@ -29,7 +29,44 @@ tags:
29
  >
30
  > To run these files with MTP you need a custom build of **llama.cpp** that includes the MTP/speculative
31
  > decoding support from [PR #22673](https://github.com/ggml-org/llama.cpp/pull/22673). Follow the steps below.
32
- >
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
33
  > ---
34
  >
35
  > ### Building llama.cpp with MTP Support — Step by Step
@@ -57,7 +94,7 @@ tags:
57
  > #### 4. Checkout master and reset to latest remote
58
  > ```bash
59
  > git checkout master
60
- > git reset --hard 5207d120e
61
  > ```
62
  > Ensures a clean starting point at the current upstream master, discarding any local drift.
63
  >
 
29
  >
30
  > To run these files with MTP you need a custom build of **llama.cpp** that includes the MTP/speculative
31
  > decoding support from [PR #22673](https://github.com/ggml-org/llama.cpp/pull/22673). Follow the steps below.
32
+ >
33
+ > ---
34
+ >
35
+ > ### 🐳 Or Use Pre-built Docker Images (Recommended)
36
+ >
37
+ > Don't want to build from source? Ready-to-use Docker images with MTP support are available for multiple backends:
38
+ >
39
+ >
40
+ > | Image | Backend |
41
+ > |---|---|
42
+ > | `havenoammo/llama:cuda13-server` | CUDA 13 |
43
+ > | `havenoammo/llama:cuda12-server` | CUDA 12 |
44
+ > | `havenoammo/llama:vulkan-server` | Vulkan |
45
+ > | `havenoammo/llama:intel-server` | Intel (CPU/Xe) |
46
+ > | `havenoammo/llama:rocm-server` | ROCm (AMD) |
47
+ >
48
+ > Quick start — running this model via Docker:
49
+ > ```bash
50
+ > docker run --gpus all --rm \
51
+ > -p 8080:8080 \
52
+ > -v ./models:/models \
53
+ > havenoammo/llama:cuda13-server \
54
+ > -m /models/Qwen3.6-35B-A3B-MTP-UD-Q8_K_XL.gguf \
55
+ > --port 8080 --host 0.0.0.0 \
56
+ > -n -1 --parallel 1 \
57
+ > --ctx-size 262144 --fit-target 844 \
58
+ > --mmap -ngl -1 --flash-attn on \
59
+ > --temp 1.0 --min-p 0.0 --top-p 0.95 --top-k 20 \
60
+ > --jinja \
61
+ > --chat-template-kwargs '{"preserve_thinking":true}' \
62
+ > --ubatch-size 512 --batch-size 2048 \
63
+ > --cache-type-k q8_0 --cache-type-v q8_0 \
64
+ > --spec-type mtp \
65
+ > --spec-draft-n-max 3
66
+ > ```
67
+ > The two flags that matter most for MTP are `--spec-type mtp` and `--spec-draft-n-max 3`.
68
+ > See the [Reddit post](https://www.reddit.com/r/LocalLLaMA/comments/1tc132c/) for more details and discussion.
69
+ >
70
  > ---
71
  >
72
  > ### Building llama.cpp with MTP Support — Step by Step
 
94
  > #### 4. Checkout master and reset to latest remote
95
  > ```bash
96
  > git checkout master
97
+ > git reset --hard 856c3adac
98
  > ```
99
  > Ensures a clean starting point at the current upstream master, discarding any local drift.
100
  >