Instructions to use GreenBitAI/Qwen3.8-27B-4bit with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use GreenBitAI/Qwen3.8-27B-4bit 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("GreenBitAI/Qwen3.8-27B-4bit") config = load_config("GreenBitAI/Qwen3.8-27B-4bit") # 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
- Pi
How to use GreenBitAI/Qwen3.8-27B-4bit with Pi:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "GreenBitAI/Qwen3.8-27B-4bit"
Configure the model in Pi
# Install Pi: npm install -g @earendil-works/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "mlx-lm": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "GreenBitAI/Qwen3.8-27B-4bit" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent
How to use GreenBitAI/Qwen3.8-27B-4bit with Hermes Agent:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "GreenBitAI/Qwen3.8-27B-4bit"
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 GreenBitAI/Qwen3.8-27B-4bit
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use GreenBitAI/Qwen3.8-27B-4bit with OpenClaw:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "GreenBitAI/Qwen3.8-27B-4bit"
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 "GreenBitAI/Qwen3.8-27B-4bit" \ --custom-provider-id mlx-lm \ --custom-compatibility openai \ --custom-text-input \ --accept-risk \ --skip-health
Run OpenClaw
openclaw agent --local --agent main --message "Hello from Hugging Face"
Qwen3.8-27B, 4-bit, with its draft head
Qwen3.8-27B quantized to four bits for MLX, carrying the model's own multi-token
prediction head in mtp/. Speculative decoding therefore works from this
repository alone -- nothing else to fetch, no environment variable pointing
somewhere else.
Generation runs 1.8-2.3x faster with the head on, and says the same thing. Every token it proposes is checked by the model itself, so the reply is the model's own either way; the head only saves passes over the weights.
Speed
Measured on a 48 GB MacBook Pro (M4 Pro), greedy decoding, 96 tokens, with
gbx_lm. Decode is timed from the first token, so prefill is not in it.
| context | decode, head off | decode, head on | draft acceptance |
|---|---|---|---|
| 1,024 | 14.7 tok/s | 33.8 tok/s | 0.95 |
| 4,096 | 14.3 | 27.3 | 0.78 |
| 16,384 | 13.5 | 24.8 | 0.78 |
Requirements
| macOS | 15.0 or later |
| chip | Apple Silicon (arm64). There is no Intel build. |
| Python | none -- the binary carries what it needs |
These weights are held resident, not paged: on a 512 GB Mac Studio the model settles at about 16 GB, and a machine needs room for that much plus the conversation's cache.
Install
curl -fL -o gbx_lm-darwin-arm64.tar.gz 'https://github.com/GreenBitAI/gbx-lm/releases/latest/download/gbx_lm-darwin-arm64.tar.gz' \
&& tar -xzf gbx_lm-darwin-arm64.tar.gz gbx_lm \
&& mkdir -p "$HOME/.local/bin" \
&& mv gbx_lm "$HOME/.local/bin/gbx_lm" \
&& chmod +x "$HOME/.local/bin/gbx_lm"
gbx_lm -h
command not found means $HOME/.local/bin is not on your PATH: add it, or
call the binary by its full path. The build is signed with a Developer ID and
notarised, so macOS runs it without the usual detour for a downloaded binary.
Run
gbx_lm --model GreenBitAI/Qwen3.8-27B-4bit
# the draft head is off unless asked for, and found in `mtp/` without a path
GBX_QWEN35_MTP=on gbx_lm --model GreenBitAI/Qwen3.8-27B-4bit
That serves an OpenAI-compatible API on port 11688, which is its default. The
weights download on first use into ~/.libra/cache/models; set HF_HOME to put
them elsewhere, and HF_TOKEN if you meet the Hub's rate limits for anonymous
downloads.
curl http://127.0.0.1:11688/v1/chat/completions \
-H 'Content-Type: application/json' \
-d '{"model":"GreenBitAI/Qwen3.8-27B-4bit","messages":[{"role":"user","content":"Hello"}]}'
Coding agents
The server speaks three wire protocols on the same port, so the tools that expect a hosted API can be pointed at this one:
| path | for |
|---|---|
/v1/chat/completions |
anything written against the OpenAI API |
/v1/responses |
Codex |
/v1/messages |
Claude Code |
Codex -- a provider in ~/.codex/config.toml:
[model_providers.gbx]
name = "gbx-lm"
base_url = "http://127.0.0.1:11688/v1"
wire_api = "responses"
and a profile in ~/.codex/gbx.config.toml:
model_provider = "gbx"
model = "GreenBitAI/Qwen3.8-27B-4bit"
model_context_window = 262144
Claude Code -- ~/.claude/gbx.settings.json:
{
"env": {
"ANTHROPIC_BASE_URL": "http://127.0.0.1:11688",
"ANTHROPIC_AUTH_TOKEN": "local",
"ANTHROPIC_MODEL": "GreenBitAI/Qwen3.8-27B-4bit",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "GreenBitAI/Qwen3.8-27B-4bit"
}
}
Both clients ask for a small model for their own background work, so every name in the settings has to be one this server is serving.
What is in here
mtp/mtp.safetensors is built from the draft head
Qwen/Qwen3.8-27B ships under mtp.,
quantized to match these weights. Apache 2.0, as the original is.
- Downloads last month
- 94
4-bit
Model tree for GreenBitAI/Qwen3.8-27B-4bit
Base model
Qwen/Qwen3.8-27B