Instructions to use mlx-community/flint-OptiQ-4bit with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Libraries

How to use mlx-community/flint-OptiQ-4bit 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("mlx-community/flint-OptiQ-4bit")

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

How to use mlx-community/flint-OptiQ-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 "mlx-community/flint-OptiQ-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": "mlx-community/flint-OptiQ-4bit"
        }
      ]
    }
  }
}

Run Pi

# Start Pi in your project directory:
pi

MLX LM

How to use mlx-community/flint-OptiQ-4bit with MLX LM:

Generate or start a chat session

# Install MLX LM
uv tool install mlx-lm
# Interactive chat REPL
mlx_lm.chat --model "mlx-community/flint-OptiQ-4bit"

Run an OpenAI-compatible server

# Install MLX LM
uv tool install mlx-lm
# Start the server
mlx_lm.server --model "mlx-community/flint-OptiQ-4bit"
# Calling the OpenAI-compatible server with curl
curl -X POST "http://localhost:8000/v1/chat/completions" \
   -H "Content-Type: application/json" \
   --data '{
     "model": "mlx-community/flint-OptiQ-4bit",
     "messages": [
       {"role": "user", "content": "Hello"}
     ]
   }'

Hermes Agent

How to use mlx-community/flint-OptiQ-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 "mlx-community/flint-OptiQ-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 mlx-community/flint-OptiQ-4bit

Run Hermes

hermes

Atomic Chat

OpenClaw

How to use mlx-community/flint-OptiQ-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 "mlx-community/flint-OptiQ-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 "mlx-community/flint-OptiQ-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"

flint-OptiQ-4bit / tokenizer_config.json

sandeep85

Add files using upload-large-folder tool

d5efe41 verified 4 days ago

Raw History Blame Contribute Delete

3.8 kB

{
  "backend": "tokenizers",
  "bos_token": "<|begin_of_text|>",
  "clean_up_tokenization_spaces": false,
  "eos_token": "<|end_of_text|>",
  "extra_special_tokens": [
    "<|system|>",
    "<|user|>",
    "<|assistant|>",
    "<|observation|>",
    "<|developer|>",
    "<|reserved_150019|>",
    "<|reserved_150020|>",
    "<|reserved_150021|>",
    "<|reserved_150022|>",
    "<|reserved_150023|>",
    "<|reserved_150024|>",
    "<|reserved_150025|>",
    "<|reserved_150026|>",
    "<|reserved_150027|>",
    "<|reserved_150028|>",
    "<|reserved_150029|>",
    "<|reserved_150030|>",
    "<|reserved_150031|>",
    "<|reserved_150032|>",
    "<|reserved_150033|>",
    "<|reserved_150034|>",
    "<|reserved_150035|>",
    "<|reserved_150036|>",
    "<|reserved_150037|>",
    "<|reserved_150038|>",
    "<|reserved_150039|>",
    "<|reserved_150040|>",
    "<|reserved_150041|>",
    "<|reserved_150042|>",
    "<|reserved_150043|>",
    "<|reserved_150044|>",
    "<|reserved_150045|>",
    "<|reserved_150046|>",
    "<|reserved_150047|>",
    "<|reserved_150048|>",
    "<|reserved_150049|>",
    "<|reserved_150050|>",
    "<|reserved_150051|>",
    "<|reserved_150052|>",
    "<|reserved_150053|>",
    "<|reserved_150054|>",
    "<|reserved_150055|>",
    "<|reserved_150056|>",
    "<|reserved_150057|>",
    "<|reserved_150058|>",
    "<|reserved_150059|>",
    "<|reserved_150060|>",
    "<|reserved_150061|>",
    "<|reserved_150062|>",
    "<|reserved_150063|>",
    "<|reserved_150064|>",
    "<|reserved_150065|>",
    "<|reserved_150066|>",
    "<|reserved_150067|>",
    "<|reserved_150068|>",
    "<|reserved_150069|>",
    "<|reserved_150070|>",
    "<|reserved_150071|>",
    "<|reserved_150072|>",
    "<|reserved_150073|>",
    "<|reserved_150074|>",
    "<|reserved_150075|>",
    "<|reserved_150076|>",
    "<|reserved_150077|>",
    "<|reserved_150078|>",
    "<|reserved_150079|>",
    "<|reserved_150080|>",
    "<|reserved_150081|>",
    "<|reserved_150082|>",
    "<|reserved_150083|>",
    "<|reserved_150084|>",
    "<|reserved_150085|>",
    "<|reserved_150086|>",
    "<|reserved_150087|>",
    "<|reserved_150088|>",
    "<|reserved_150089|>",
    "<|reserved_150090|>",
    "<|reserved_150091|>",
    "<|reserved_150092|>",
    "<|reserved_150093|>",
    "<|reserved_150094|>",
    "<|reserved_150095|>",
    "<|reserved_150096|>",
    "<|reserved_150097|>",
    "<|reserved_150098|>",
    "<|reserved_150099|>",
    "<|reserved_150100|>",
    "<|reserved_150101|>",
    "<|reserved_150102|>",
    "<|reserved_150103|>",
    "<|reserved_150104|>",
    "<|reserved_150105|>",
    "<|reserved_150106|>",
    "<|reserved_150107|>",
    "<|reserved_150108|>",
    "<|reserved_150109|>",
    "<|reserved_150110|>",
    "<|reserved_150111|>",
    "<|reserved_150112|>",
    "<|reserved_150113|>",
    "<|reserved_150114|>",
    "<|reserved_150115|>",
    "<|reserved_150116|>",
    "<|reserved_150117|>",
    "<|reserved_150118|>",
    "<|reserved_150119|>",
    "<|reserved_150120|>",
    "<|reserved_150121|>",
    "<|reserved_150122|>",
    "<|reserved_150123|>",
    "<|reserved_150124|>",
    "<|reserved_150125|>",
    "<|reserved_150126|>",
    "<|reserved_150127|>",
    "<|reserved_150128|>",
    "<|reserved_150129|>",
    "<|reserved_150130|>",
    "<|reserved_150131|>",
    "<|reserved_150132|>",
    "<|reserved_150133|>",
    "<|reserved_150134|>",
    "<|reserved_150135|>",
    "<|reserved_150136|>",
    "<|reserved_150137|>",
    "<|reserved_150138|>",
    "<|reserved_150139|>",
    "<|reserved_150140|>",
    "<|reserved_150141|>",
    "<|reserved_150142|>",
    "<|reserved_150143|>"
  ],
  "is_local": true,
  "local_files_only": false,
  "model_max_length": 262144,
  "tokenizer_class": "TokenizersBackend",
  "tool_parser_type": "glm47"
}

	{
	"backend": "tokenizers",
	"bos_token": "<\|begin_of_text\|>",
	"clean_up_tokenization_spaces": false,
	"eos_token": "<\|end_of_text\|>",
	"extra_special_tokens": [
	"<\|system\|>",
	"<\|user\|>",
	"<\|assistant\|>",
	"<\|observation\|>",
	"<\|developer\|>",
	"<\|reserved_150019\|>",
	"<\|reserved_150020\|>",
	"<\|reserved_150021\|>",
	"<\|reserved_150022\|>",
	"<\|reserved_150023\|>",
	"<\|reserved_150024\|>",
	"<\|reserved_150025\|>",
	"<\|reserved_150026\|>",
	"<\|reserved_150027\|>",
	"<\|reserved_150028\|>",
	"<\|reserved_150029\|>",
	"<\|reserved_150030\|>",
	"<\|reserved_150031\|>",
	"<\|reserved_150032\|>",
	"<\|reserved_150033\|>",
	"<\|reserved_150034\|>",
	"<\|reserved_150035\|>",
	"<\|reserved_150036\|>",
	"<\|reserved_150037\|>",
	"<\|reserved_150038\|>",
	"<\|reserved_150039\|>",
	"<\|reserved_150040\|>",
	"<\|reserved_150041\|>",
	"<\|reserved_150042\|>",
	"<\|reserved_150043\|>",
	"<\|reserved_150044\|>",
	"<\|reserved_150045\|>",
	"<\|reserved_150046\|>",
	"<\|reserved_150047\|>",
	"<\|reserved_150048\|>",
	"<\|reserved_150049\|>",
	"<\|reserved_150050\|>",
	"<\|reserved_150051\|>",
	"<\|reserved_150052\|>",
	"<\|reserved_150053\|>",
	"<\|reserved_150054\|>",
	"<\|reserved_150055\|>",
	"<\|reserved_150056\|>",
	"<\|reserved_150057\|>",
	"<\|reserved_150058\|>",
	"<\|reserved_150059\|>",
	"<\|reserved_150060\|>",
	"<\|reserved_150061\|>",
	"<\|reserved_150062\|>",
	"<\|reserved_150063\|>",
	"<\|reserved_150064\|>",
	"<\|reserved_150065\|>",
	"<\|reserved_150066\|>",
	"<\|reserved_150067\|>",
	"<\|reserved_150068\|>",
	"<\|reserved_150069\|>",
	"<\|reserved_150070\|>",
	"<\|reserved_150071\|>",
	"<\|reserved_150072\|>",
	"<\|reserved_150073\|>",
	"<\|reserved_150074\|>",
	"<\|reserved_150075\|>",
	"<\|reserved_150076\|>",
	"<\|reserved_150077\|>",
	"<\|reserved_150078\|>",
	"<\|reserved_150079\|>",
	"<\|reserved_150080\|>",
	"<\|reserved_150081\|>",
	"<\|reserved_150082\|>",
	"<\|reserved_150083\|>",
	"<\|reserved_150084\|>",
	"<\|reserved_150085\|>",
	"<\|reserved_150086\|>",
	"<\|reserved_150087\|>",
	"<\|reserved_150088\|>",
	"<\|reserved_150089\|>",
	"<\|reserved_150090\|>",
	"<\|reserved_150091\|>",
	"<\|reserved_150092\|>",
	"<\|reserved_150093\|>",
	"<\|reserved_150094\|>",
	"<\|reserved_150095\|>",
	"<\|reserved_150096\|>",
	"<\|reserved_150097\|>",
	"<\|reserved_150098\|>",
	"<\|reserved_150099\|>",
	"<\|reserved_150100\|>",
	"<\|reserved_150101\|>",
	"<\|reserved_150102\|>",
	"<\|reserved_150103\|>",
	"<\|reserved_150104\|>",
	"<\|reserved_150105\|>",
	"<\|reserved_150106\|>",
	"<\|reserved_150107\|>",
	"<\|reserved_150108\|>",
	"<\|reserved_150109\|>",
	"<\|reserved_150110\|>",
	"<\|reserved_150111\|>",
	"<\|reserved_150112\|>",
	"<\|reserved_150113\|>",
	"<\|reserved_150114\|>",
	"<\|reserved_150115\|>",
	"<\|reserved_150116\|>",
	"<\|reserved_150117\|>",
	"<\|reserved_150118\|>",
	"<\|reserved_150119\|>",
	"<\|reserved_150120\|>",
	"<\|reserved_150121\|>",
	"<\|reserved_150122\|>",
	"<\|reserved_150123\|>",
	"<\|reserved_150124\|>",
	"<\|reserved_150125\|>",
	"<\|reserved_150126\|>",
	"<\|reserved_150127\|>",
	"<\|reserved_150128\|>",
	"<\|reserved_150129\|>",
	"<\|reserved_150130\|>",
	"<\|reserved_150131\|>",
	"<\|reserved_150132\|>",
	"<\|reserved_150133\|>",
	"<\|reserved_150134\|>",
	"<\|reserved_150135\|>",
	"<\|reserved_150136\|>",
	"<\|reserved_150137\|>",
	"<\|reserved_150138\|>",
	"<\|reserved_150139\|>",
	"<\|reserved_150140\|>",
	"<\|reserved_150141\|>",
	"<\|reserved_150142\|>",
	"<\|reserved_150143\|>"
	],
	"is_local": true,
	"local_files_only": false,
	"model_max_length": 262144,
	"tokenizer_class": "TokenizersBackend",
	"tool_parser_type": "glm47"
	}