Instructions to use InterpreticAI/Inkling-2-Mini-MLX-4bit with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use InterpreticAI/Inkling-2-Mini-MLX-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("InterpreticAI/Inkling-2-Mini-MLX-4bit") config = load_config("InterpreticAI/Inkling-2-Mini-MLX-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 InterpreticAI/Inkling-2-Mini-MLX-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 "InterpreticAI/Inkling-2-Mini-MLX-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": "InterpreticAI/Inkling-2-Mini-MLX-4bit" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent
How to use InterpreticAI/Inkling-2-Mini-MLX-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 "InterpreticAI/Inkling-2-Mini-MLX-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 InterpreticAI/Inkling-2-Mini-MLX-4bit
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use InterpreticAI/Inkling-2-Mini-MLX-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 "InterpreticAI/Inkling-2-Mini-MLX-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 "InterpreticAI/Inkling-2-Mini-MLX-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"
Inkling-2-Mini-MLX-4bit
Inkling 2 Mini is a multimodal looped mixture-of-experts model from Thinking Machines Lab: 26.4B parameters, 3.4B active (5.4B effective with three passes through the looped middle layers), text and image input, up to 1M tokens of context. This repository is an unmodified quantization of the official checkpoint (revision 1fb4134).
MLX build for Apple Silicon (MLX, oMLX, LM Studio). Runs on a Mac with 32 GB of unified memory or more.
Other formats from INTERPRETIC AI: GGUF Q4_K_M · GGUF IQ3_XXS · MLX 4-bit
Files
Four model-0000N-of-00004.safetensors shards (17 GB in total), the configuration and the tokenizer. The vision tower is included in bfloat16. The routed experts keep the original NVFP4 quantization. Attention, embedding and output weights are 4-bit (group size 64). SHA-256 checksums are listed in SHA256SUMS.
Usage
Inkling 2 Mini support in mlx-lm is in ml-explore/mlx-lm#2086 and not yet in a release.
pip install -U "git+https://github.com/ml-explore/mlx-lm.git@refs/pull/2086/head"
mlx_lm.generate --model InterpreticAI/Inkling-2-Mini-MLX-4bit --prompt "Hello" --max-tokens 512
Tested with text input. Image input through mlx-vlm has not been tested.
Notes
- Inkling 2 Mini is a thinking model: it writes its reasoning before the answer. Use a chat client or server that applies the model's chat template.
- Quality checks here are spot checks (English, Chinese, code and one image), not a full benchmark.
- Support for this architecture is new in all runtimes. Use a recent build.
License
Apache 2.0, as the original model. See the model card of Thinking Machines Lab and its acceptable use policy.
INTERPRETIC AI · interpretic.ai
- Downloads last month
- -
4-bit
Model tree for InterpreticAI/Inkling-2-Mini-MLX-4bit
Base model
thinkingmachines/Inkling-2-Mini
# 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("InterpreticAI/Inkling-2-Mini-MLX-4bit") config = load_config("InterpreticAI/Inkling-2-Mini-MLX-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)