Instructions to use mlx-community/Inkling-2-Mini-oQ4e-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-oQ4e-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-oQ4e-mtp") config = load_config("mlx-community/Inkling-2-Mini-oQ4e-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-oQ4e-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-oQ4e-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-oQ4e-mtp" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent
How to use mlx-community/Inkling-2-Mini-oQ4e-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-oQ4e-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-oQ4e-mtp
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use mlx-community/Inkling-2-Mini-oQ4e-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-oQ4e-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-oQ4e-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-oQ4e-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 4.915 bits/weight for the language model and vision encoder, or 5.047 bits/weight including the DSpark draft.
Quantization and Bit Distribution
oQ4e keeps the routed experts of layers 0 to 19 in their source NVFP4 format and requantizes the MXFP8 experts of layers 20 to 23 to affine 4-bit. 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 |
|---|---|---|---|---|
| NVFP4, group 16 | 20.384B | 77.247% | 10.679 GiB | 4.50 |
| Affine 4-bit, group 64 | 4.077B | 15.449% | 2.136 GiB | 4.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% | 15.098 GiB | 4.915 |
Storage Breakdown
| Component | Logical weights | Storage |
|---|---|---|
| Language model | 26.070B | 15.575 GB / 14.505 GiB |
| Vision | 0.318B | 0.637 GB / 0.593 GiB |
| DSpark draft (MTP) | 0.318B | 0.636 GB / 0.592 GiB |
| Total | 26.707B | 16.847 GB / 15.690 GiB |
License
Apache 2.0, following the source model.
- Downloads last month
- -
4-bit
Model tree for mlx-community/Inkling-2-Mini-oQ4e-mtp
Base model
thinkingmachines/Inkling-2-Mini