Instructions to use bwn2000/moeme-27b with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use bwn2000/moeme-27b with llama.cpp:
Install (macOS, Linux)
curl -LsSf https://llama.app/install.sh | sh # Start a local OpenAI-compatible server with a web UI: llama serve -hf bwn2000/moeme-27b:Q4_K_M # Run inference directly in the terminal: llama cli -hf bwn2000/moeme-27b:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf bwn2000/moeme-27b:Q4_K_M # Run inference directly in the terminal: llama cli -hf bwn2000/moeme-27b:Q4_K_M
Use pre-built binary
# Download pre-built binary from: # https://github.com/ggerganov/llama.cpp/releases # Start a local OpenAI-compatible server with a web UI: ./llama-server -hf bwn2000/moeme-27b:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf bwn2000/moeme-27b:Q4_K_M
Build from source code
git clone https://github.com/ggerganov/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-server llama-cli # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama-server -hf bwn2000/moeme-27b:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf bwn2000/moeme-27b:Q4_K_M
Use Docker
docker model run hf.co/bwn2000/moeme-27b:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use bwn2000/moeme-27b with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "bwn2000/moeme-27b" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "bwn2000/moeme-27b", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/bwn2000/moeme-27b:Q4_K_M
- Ollama
How to use bwn2000/moeme-27b with Ollama:
ollama run hf.co/bwn2000/moeme-27b:Q4_K_M
- Unsloth Desktop
- Pi
How to use bwn2000/moeme-27b with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf bwn2000/moeme-27b:Q4_K_M
Configure the model in Pi
# Install Pi: npm install -g @earendil-works/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "llama-cpp": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "bwn2000/moeme-27b:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use bwn2000/moeme-27b with Docker Model Runner:
docker model run hf.co/bwn2000/moeme-27b:Q4_K_M
- Lemonade
How to use bwn2000/moeme-27b with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull bwn2000/moeme-27b:Q4_K_M
Run and chat with the model
lemonade run user.moeme-27b-Q4_K_M
List all available models
lemonade list
- Hermes Agent
How to use bwn2000/moeme-27b with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf bwn2000/moeme-27b:Q4_K_M
Configure Hermes
# Install Hermes: curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash hermes setup # Point Hermes at the local server: hermes config set model.provider custom hermes config set model.base_url http://127.0.0.1:8080/v1 hermes config set model.default bwn2000/moeme-27b:Q4_K_M
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use bwn2000/moeme-27b with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf bwn2000/moeme-27b:Q4_K_M
Configure OpenClaw
# Install OpenClaw: npm install -g openclaw@latest # Register the local server and set it as the default model: openclaw onboard --non-interactive --mode local \ --auth-choice custom-api-key \ --custom-base-url http://127.0.0.1:8080/v1 \ --custom-model-id "bwn2000/moeme-27b:Q4_K_M" \ --custom-provider-id llama-cpp \ --custom-compatibility openai \ --custom-text-input \ --accept-risk \ --skip-health
Run OpenClaw
openclaw agent --local --agent main --message "Hello from Hugging Face"
MoEMe-27B — exact Top-12 sparse-MoE conversion of Qwen3.8-27B
Two GGUF builds of a mechanically converted sparse-MoE version of Qwen3.8-27B. The dense SwiGLU feed-forward networks were re-partitioned into a MoE layout by checkpoint surgery. These are exact Top-12 conversions — all 12 routed experts are active, so the model is functionally the source dense model, reorganized and quantized. It is not a new or improved model, and it is not a quality-preserving sparse model.
This weights release accompanies the source release and the experiment write-up: the conversion works, the sparsity does not. Read the repository before using this for anything serious.
Files
| File | Size | Notes |
|---|---|---|
moeme-27b-top12-imatrix-q5_k_m.gguf |
18.53 GiB | Recommended. Passes the full 16/16 capability suite and all source-logit parity gates. ~3.2–3.3 tok/s on an RTX 4060 Laptop (8 GB). |
moeme-27b-top12-imatrix-q4_k_m.gguf |
16.15 GiB | Faster (~3.8 tok/s), smaller, but misses the mean-KLD parity gate by 0.000102 (0.020102 vs 0.02). Use if memory-constrained. |
SHA-256:
9996f4b352fe2c7016ecb675d11deb4e5eef99456b510478dc01b853bddffd38 moeme-27b-top12-imatrix-q5_k_m.gguf
3797152bf530563ea7787162f2f1bfd4cf2e9cf1e780b041d21b2a0a56551f94 moeme-27b-top12-imatrix-q4_k_m.gguf
What was changed
Qwen3.8-27B has num_hidden_layers = 64 (48 linear-attention + 16 full-attention),
hidden_size = 5120, FFN intermediate_size = 17408, vocab 248320, native
context 262144. Each dense FFN intermediate dimension F = 17408 was split into
a disjoint partition: F/4 = 4352 shared channels plus 12 × F/16 = 1088 routed
channels (4352 + 12 × 1088 = 17408). Nothing was added; channels were
reassigned. This is the root cause of the whole experiment's failure: Top-K
routing deletes network width instead of selecting redundant, independently
trained expert capacity.
Requirements — patched llama.cpp
These GGUFs need a llama.cpp build that (a) loads qwen35moe.expert_weights_scale
in the Qwen35MoE loader and (b) honours the per-layer active-K override env vars
(MOEME_ACTIVE_K, MOEME_ACTIVE_K_LAYERS). A stock build will load the file but
produce wrong logits. The required one-line loader patch is included in the
source repository under docs/patches/.
Run
llama-server \
-m moeme-27b-top12-imatrix-q5_k_m.gguf \
-c 8192 -ngl 20 -fa \
--cache-type-k q8_0 --cache-type-v q8_0 \
--ctx-checkpoints 2 --fit off
The host used for the published benchmarks was an RTX 4060 Laptop (8 GB VRAM),
15.7 GiB RAM, 16 cores. The flags above were measured on that host; adjust for
your hardware. Context checkpoints reserve significant RAM, so keep
--ctx-checkpoints low on small machines.
Honest limitations
- No real sparse speedup. Only ~`49.4%
of the artifact bytes live in routed experts; the other ~50.6%is always active. The theoretical ceiling is1.96x; the measured Top-4 speedup is1.42x`. On a bandwidth-bound single device, routing reduces FLOPs, not bytes moved. - Sparsity destroys quality. The calibrated quality budget is a per-layer
relative-L2 error of ~`0.01
. The static greedy-oracle floor at Top-4 has a **median of0.45** across the 64 layers (best layer0.16, worst0.53). No layer clears the real budget at anyK < 12`. - Not a chat-tuned model. It is the source model's weights, reorganized; behavior and safety characteristics are inherited from Qwen3.8-27B.
License & credits
Apache-2.0, inherited from the base model. Built on Qwen3.8-27B (Apache-2.0) and llama.cpp (MIT).
If you have a real compute budget and want to attempt the co-activation clustering / upcycling / sparse-aware-training route this hardware could not reach, please do — that is why this was released.
- Downloads last month
- 23
4-bit
5-bit
Model tree for bwn2000/moeme-27b
Base model
Qwen/Qwen3.8-27B