Instructions to use mlx-community/Inkling-2-Mini-oQ2.5e-mtp with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use mlx-community/Inkling-2-Mini-oQ2.5e-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("mlx-community/Inkling-2-Mini-oQ2.5e-mtp") config = load_config("mlx-community/Inkling-2-Mini-oQ2.5e-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 mlx-community/Inkling-2-Mini-oQ2.5e-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 "mlx-community/Inkling-2-Mini-oQ2.5e-mtp"
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": "mlx-community/Inkling-2-Mini-oQ2.5e-mtp" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent
How to use mlx-community/Inkling-2-Mini-oQ2.5e-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 "mlx-community/Inkling-2-Mini-oQ2.5e-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 mlx-community/Inkling-2-Mini-oQ2.5e-mtp
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use mlx-community/Inkling-2-Mini-oQ2.5e-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 "mlx-community/Inkling-2-Mini-oQ2.5e-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 "mlx-community/Inkling-2-Mini-oQ2.5e-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"
Inkling-2-Mini-oQ2.5e-mtp
This model was quantized using oQ (oMLX v0.8.1) mixed-precision quantization.
A mixed-precision MLX checkpoint of thinkingmachines/Inkling-2-Mini, a looped multimodal mixture-of-experts model with 26.4B total and 3.4B active parameters. Its middle 12 layers run three times for each token. It takes text and image inputs with a context window of up to 1M tokens. It includes the language model, the vision encoder and the bundled DSpark draft in mtp.safetensors, which oMLX Lightning MTP uses for speculative decoding.
It needs oMLX 0.8.1 or later.
The effective average is 3.305 bits/weight for the language model and vision encoder, or 3.457 bits/weight including the DSpark draft.
Quantization and Bit Distribution
oQ2.5e requantizes the routed experts of all layers. The gate and up projections use affine 2-bit. The down projections use affine 3-bit in 19 layers, including all looped layers, and affine 2-bit in layers 3, 4, 5, 20 and 22. It stores the attention projections, the embeddings and the vocabulary head as affine 8-bit. The vision encoder and the DSpark draft keep BF16, and the router and the loop controllers keep FP32.
| Storage format | Logical weights | Share of total | Tensor storage | Effective bits/weight |
|---|---|---|---|---|
| Affine 2-bit, group 64 | 18.006B | 68.234% | 5.240 GiB | 2.50 |
| Affine 3-bit, group 64 | 6.455B | 24.461% | 2.630 GiB | 3.50 |
| Affine 8-bit, group 64 | 1.572B | 5.958% | 1.556 GiB | 8.50 |
| BF16 | 0.320B | 1.211% | 0.595 GiB | 16.00 |
| FP32 | 0.036B | 0.135% | 0.133 GiB | 32.00 |
| Total | 26.389B | 100% | 10.154 GiB | 3.305 |
Storage Breakdown
| Component | Logical weights | Storage |
|---|---|---|
| Language model | 26.070B | 10.267 GB / 9.562 GiB |
| Vision | 0.318B | 0.637 GB / 0.593 GiB |
| DSpark draft (MTP) | 0.318B | 0.636 GB / 0.592 GiB |
| Total | 26.707B | 11.539 GB / 10.746 GiB |
License
Apache 2.0, following the source model.
- Downloads last month
- 129
2-bit
Model tree for mlx-community/Inkling-2-Mini-oQ2.5e-mtp
Base model
thinkingmachines/Inkling-2-Mini