Instructions to use mlx-community/Qwythos-27B-v1-OptiQ-4bit with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use mlx-community/Qwythos-27B-v1-OptiQ-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("mlx-community/Qwythos-27B-v1-OptiQ-4bit") config = load_config("mlx-community/Qwythos-27B-v1-OptiQ-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 mlx-community/Qwythos-27B-v1-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/Qwythos-27B-v1-OptiQ-4bit"
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": "mlx-community/Qwythos-27B-v1-OptiQ-4bit" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use mlx-community/Qwythos-27B-v1-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/Qwythos-27B-v1-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/Qwythos-27B-v1-OptiQ-4bit
Run Hermes
hermes
- OpenClaw new
How to use mlx-community/Qwythos-27B-v1-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/Qwythos-27B-v1-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/Qwythos-27B-v1-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"
mlx-community/Qwythos-27B-v1-OptiQ-4bit
Built with mlx-optiq, the MLX-native toolkit to quantize, fine-tune, and serve LLMs locally on Apple Silicon, no PyTorch and no cloud. All OptiQ quants · Docs
OptiQ mixed-precision quant of empero-ai/Qwythos-27B-v1, a Qwen3.5-family vision-language model (image + text, long context, with a bundled MTP speculation head). 19 GB on disk.
What it is
| Property | Value |
|---|---|
| Base | empero-ai/Qwythos-27B-v1 (Qwen3.5-VL, 64-layer hybrid linear + full attention) |
| Method | OptiQ mixed-precision, per-layer 4/8-bit |
| Bit allocation | Reused from the base Qwen3.5-27B OptiQ recipe: the architecture is identical, so the per-layer sensitivity ranking transfers directly and no per-model sensitivity sweep is needed |
| Layer split | 279 layers at 4-bit, 219 at 8-bit |
| Achieved bits-per-weight | 5.55 |
| On disk | 19 GB |
| MTP | Speculation head preserved in optiq/mtp.safetensors for faster decode via optiq serve --mtp |
| Vision | bf16 vision tower kept in optiq/optiq_vision.safetensors for image and video-frame input |
Following the naming llama.cpp uses for its mixed quants, the "4bit" label denotes the family, not the weighted average.
Run it
Qwen3.5 plus the MTP and vision sidecars register through OptiQ, so import optiq once before loading:
pip install "mlx-optiq>=0.4.7"
import optiq # registers the arch + MTP/vision sidecars
from mlx_lm import load, generate
model, tok = load("mlx-community/Qwythos-27B-v1-OptiQ-4bit")
prompt = tok.apply_chat_template(
[{"role": "user", "content": "Explain mixed-precision quantization in two sentences."}],
tokenize=False, add_generation_prompt=True,
)
print(generate(model, tok, prompt=prompt, max_tokens=400))
For image and video input, plus an OpenAI + Anthropic-compatible endpoint with the MTP speculation head and mixed-precision KV cache:
optiq serve --model mlx-community/Qwythos-27B-v1-OptiQ-4bit
Qwythos is a reasoning model, so give it a generous token budget.
Links
- Project website: mlx-optiq.com
- All OptiQ quants: mlx-optiq.com/models
- Base model: empero-ai/Qwythos-27B-v1
- Downloads last month
- 1
4-bit