Instructions to use cebopp1/inkling-tiny-preview with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use cebopp1/inkling-tiny-preview with MLX:
# Make sure mlx-lm is installed # pip install --upgrade mlx-lm # Generate text with mlx-lm from mlx_lm import load, generate model, tokenizer = load("cebopp1/inkling-tiny-preview") prompt = "Write a story about Einstein" messages = [{"role": "user", "content": prompt}] prompt = tokenizer.apply_chat_template( messages, add_generation_prompt=True ) text = generate(model, tokenizer, prompt=prompt, verbose=True) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- LM Studio
- Pi
How to use cebopp1/inkling-tiny-preview with Pi:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "cebopp1/inkling-tiny-preview"
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": "cebopp1/inkling-tiny-preview" } ] } } }Run Pi
# Start Pi in your project directory: pi
- MLX LM
How to use cebopp1/inkling-tiny-preview with MLX LM:
Generate or start a chat session
# Install MLX LM uv tool install mlx-lm # Interactive chat REPL mlx_lm.chat --model "cebopp1/inkling-tiny-preview"
Run an OpenAI-compatible server
# Install MLX LM uv tool install mlx-lm # Start the server mlx_lm.server --model "cebopp1/inkling-tiny-preview" # Calling the OpenAI-compatible server with curl curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "cebopp1/inkling-tiny-preview", "messages": [ {"role": "user", "content": "Hello"} ] }' - Hermes Agent
How to use cebopp1/inkling-tiny-preview 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 "cebopp1/inkling-tiny-preview"
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 cebopp1/inkling-tiny-preview
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use cebopp1/inkling-tiny-preview with OpenClaw:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "cebopp1/inkling-tiny-preview"
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 "cebopp1/inkling-tiny-preview" \ --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-tiny-preview
Research preview — not extensively tested. This model has not been extensively evaluated for coherence or alignment/safety. It can and will produce text that is incoherent, factually wrong, nonsensical, or otherwise unsafe. It is not suitable for any production or user-facing use. It is shared for research and curiosity only. Do not rely on its outputs. Unofficial and not affiliated with or endorsed by Thinking Machines.
A heavily-pruned, LoRA-healed, 4-bit MLX derivative of
thinkingmachines/Inkling-Small,
built to run on a 16 GB Apple-silicon Mac.
What it is
Inkling-Small is a large multimodal Mixture-of-Experts model (256 routed experts per MoE layer). This preview keeps only 8 of those 256 experts (a ~97% cut of the routed parameters), quantizes the result to 4-bit in MLX, and then LoRA-heals the wreckage on a small general-English corpus so it produces coherent text again. It is text-only (the vision/audio towers are dropped).
The result is a small (~8 GB) model that generates fluent, structured English — but with tiny capacity and no reliable world knowledge. It will confidently state false things (e.g. that the capital of France is "1.5 million") and cannot do arithmetic. Think of it as a demonstration that an aggressively-pruned MoE can be revived into coherence on consumer hardware — not as a useful assistant.
How it was made
- Prune — stream only 8 experts/layer from the original checkpoint (top-6-of-8 routing kept).
- Quantize — 4-bit affine (group size 64) in MLX.
- Heal — LoRA (rank 16) on attention + expert projections, trained on ~6M tokens of FineWeb-Edu. Best checkpoint at cross-entropy ≈ 2.23 (perplexity ≈ 9). The adapter is shipped separately from the base because fusing it into the 4-bit weights measurably degrades quality.
Usage
Apple-silicon Mac required (MLX).
pip install mlx mlx-lm transformers numpy
python run.py --prompt "The three primary colors are"
Greedy decoding loops badly on a model this small; run.py applies a repetition penalty (default
1.3), which you should keep. Layout: 4-bit base weights + adapter/adapters.safetensors (LoRA) +
bundled inkling_mlx/ runtime + run.py.
Example output (--prompt "The three primary colors are"):
The three primary colors are the red, white and black. The other two include yellow.
These four shades of color have been used in a variety of applications:
- Red: Used to indicate danger or urgency
- White: ...
Fluent and structured — and also wrong (the primary colors are not "red, white and black"). That is representative: coherent in form, unreliable in fact.
Limitations
- Not safety- or alignment-tested. No red-teaming, no refusal training, no evaluation. May emit false, biased, offensive, or otherwise harmful content.
- Not factual. ~97% of the routed experts were deleted; world knowledge is largely gone.
- Narrow. Healed on a small general-web sample; tends toward generic prose.
- English, text-only.
Attribution & license
- Base model:
thinkingmachines/Inkling-Small(Apache-2.0). - Bundled
inkling_mlx/runtime: frommlx-community/Inkling-Small-mlx(Apache-2.0), with a one-line modification inmoe.py(stop_gradienton expert indices) so the model can be LoRA-trained; identity at inference.
Released under Apache-2.0, inheriting the base model's license. This is a modified derivative work; it is unofficial and not affiliated with, sponsored by, or endorsed by Thinking Machines.
- Downloads last month
- 247
Quantized
Model tree for cebopp1/inkling-tiny-preview
Base model
thinkingmachines/Inkling-Small