Instructions to use wd01216-bit/Ornith-1.0-35B-MLX-3bit-MTP with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use wd01216-bit/Ornith-1.0-35B-MLX-3bit-MTP 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("wd01216-bit/Ornith-1.0-35B-MLX-3bit-MTP") config = load_config("wd01216-bit/Ornith-1.0-35B-MLX-3bit-MTP") # 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 wd01216-bit/Ornith-1.0-35B-MLX-3bit-MTP with Pi:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "wd01216-bit/Ornith-1.0-35B-MLX-3bit-MTP"
Configure the model in Pi
# Install Pi: npm install -g @mariozechner/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "mlx-lm": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "wd01216-bit/Ornith-1.0-35B-MLX-3bit-MTP" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use wd01216-bit/Ornith-1.0-35B-MLX-3bit-MTP 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 "wd01216-bit/Ornith-1.0-35B-MLX-3bit-MTP"
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 wd01216-bit/Ornith-1.0-35B-MLX-3bit-MTP
Run Hermes
hermes
- OpenClaw new
How to use wd01216-bit/Ornith-1.0-35B-MLX-3bit-MTP with OpenClaw:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "wd01216-bit/Ornith-1.0-35B-MLX-3bit-MTP"
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 "wd01216-bit/Ornith-1.0-35B-MLX-3bit-MTP" \ --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"
Ornith-1.0-35B-MLX-3bit-MTP
An Apple-Silicon MLX build of
deepreinforce-ai/Ornith-1.0-35B
that combines the 3-bit multimodal backbone from
mlx-community/Ornith-1.0-35B-3bit
with an experimental one-layer MTP head extracted from
georgeis55/Ornith-1.0-35B-MLX-oQ8-mtp.
This checkpoint is prepared for Lightning MTP speculative decoding in oMLX. The original vision encoder and VLM configuration are retained.
Technical layout
- Architecture: Qwen3.5 MoE VLM, 40 backbone layers, 256 experts
- Backbone: affine 3-bit MLX quantization, group size 64 (3.662 bits/weight)
- MTP: one full-attention MoE prediction layer at
language_model.mtp.* - MTP linears: affine 8-bit, mixed group sizes 64 and 128
- MTP fusion projection and normalization weights: BF16
- MTP file:
model-mtp-oq8.safetensors(905,114,024 bytes) - MTP SHA-256:
26358039bfc747625e8d476fede0cf619401a2ca5da9a03898d9b0c282f65c40 - Tested runtime: oMLX 0.5.3 on Apple Silicon
The weight index contains all 42 MTP tensor mappings. The configuration declares one next-token prediction layer and includes per-module quantization overrides so the 8-bit MTP tensors are not interpreted using the 3-bit backbone settings.
Download and use with oMLX
hf download wd01216-bit/Ornith-1.0-35B-MLX-3bit-MTP \
--local-dir ~/.omlx/models/wd01216-bit/Ornith-1.0-35B-MLX-3bit-MTP
In oMLX, open the model settings and enable Lightning MTP. The model identifier
will be Ornith-1.0-35B-MLX-3bit-MTP when downloaded into the directory above.
Validation
The final checkpoint was discovered and loaded successfully by oMLX 0.5.3 as a multimodal model with Native MTP active. Two short text smoke tests confirmed that the MTP decode path was used, with observed draft acceptance of 15/16 and 6/6. These tiny tests verify wiring and execution only; they are not representative benchmarks.
Important limitation
The MTP head is a verbatim graft originally sourced from a Qwopus3.6 35B model. It was not trained on Ornith hidden states, and the donor bundle was prepared around an oQ8 backbone rather than this 3-bit backbone. Acceptance rate, output quality, memory use, and speedup are workload-dependent and may be lower than those of a native jointly trained MTP head. Disable Lightning MTP if a workload shows poor acceptance or regressions.
Provenance
- Upstream model:
deepreinforce-ai/Ornith-1.0-35B - Quantized multimodal backbone:
mlx-community/Ornith-1.0-35B-3bit - MTP donor bundle and conversion notes:
georgeis55/Ornith-1.0-35B-MLX-oQ8-mtp - Adapter assembly and oMLX validation: 2026-07-27
License
The upstream Ornith model is released under the MIT license. Refer to the upstream model card and license for intended use, limitations, and attribution requirements.
- Downloads last month
- 343
3-bit
Model tree for wd01216-bit/Ornith-1.0-35B-MLX-3bit-MTP
Base model
deepreinforce-ai/Ornith-1.0-35B