Instructions to use FancieF/Qwythos-27B-v1-MLX-VLM-4bit with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use FancieF/Qwythos-27B-v1-MLX-VLM-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("FancieF/Qwythos-27B-v1-MLX-VLM-4bit") config = load_config("FancieF/Qwythos-27B-v1-MLX-VLM-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 FancieF/Qwythos-27B-v1-MLX-VLM-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 "FancieF/Qwythos-27B-v1-MLX-VLM-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": "FancieF/Qwythos-27B-v1-MLX-VLM-4bit" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use FancieF/Qwythos-27B-v1-MLX-VLM-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 "FancieF/Qwythos-27B-v1-MLX-VLM-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 FancieF/Qwythos-27B-v1-MLX-VLM-4bit
Run Hermes
hermes
- OpenClaw new
How to use FancieF/Qwythos-27B-v1-MLX-VLM-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 "FancieF/Qwythos-27B-v1-MLX-VLM-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 "FancieF/Qwythos-27B-v1-MLX-VLM-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"
Qwythos-27B-v1 · MLX VLM 4-bit
Community MLX conversion of empero-ai/Qwythos-27B-v1 for Apple Silicon. Vision tower kept. MTP head is not inside this repo — use the companion drafter.
Start here if you have ~32GB unified memory. This is the everyday chat / vision build.
Which repo should I download?
| Repo | Size | Use when |
|---|---|---|
| This one — VLM 4-bit | ~15GB | Default on M-series ≤32–48GB |
| VLM BF16 | ~55GB | High-RAM Macs, re-quant experiments |
| MTP drafter | ~829MB | Optional speed-up with mlx-vlm (--draft-model) |
Official GGUF (LM Studio / llama.cpp), including baked-in MTP: empero-ai/Qwythos-27B-v1-GGUF.
Install
pip install -U mlx-vlm
Apple Silicon only. Needs mlx-vlm >= 0.6.
Quick start
Text
mlx_vlm.generate \
--model FancieF/Qwythos-27B-v1-MLX-VLM-4bit \
--prompt "Introduce yourself in one sentence." \
--thinking-mode disabled \
--max-tokens 256 \
--temperature 0.6
Vision
mlx_vlm.generate \
--model FancieF/Qwythos-27B-v1-MLX-VLM-4bit \
--image ./photo.jpg \
--prompt "Describe this image." \
--thinking-mode disabled \
--max-tokens 256 \
--temperature 0.6
Vision + MTP (image prefill on the main model; MTP speeds text decode)
mlx_vlm.generate \
--model FancieF/Qwythos-27B-v1-MLX-VLM-4bit \
--draft-model FancieF/Qwythos-27B-v1-MLX-MTP \
--draft-kind mtp \
--draft-block-size 4 \
--image ./photo.jpg \
--prompt "Describe this image." \
--thinking-mode disabled \
--temperature 0.6
Local path works the same after hf download / ModelScope snapshot.
LM Studio note
- This MLX 4-bit + MLX MTP pair is meant for
mlx-vlmCLI/server, not LM Studio’s “Draft Model” picker (native MTP head ≠ a small peer LLM). - For LM Studio MTP, prefer official
Qwythos-27B-MTP-Q4_K_M.ggufand enable MTP Speculative Decoding.
What’s inside
- Affine 4-bit MLX safetensors (
group_size=64) language_model+vision_tower(333 vision tensors)- Chat template / processor configs from upstream
- No
mtp.*weights (stripped bymlx_vlm.convert; recovered in the MTP repo)
Sampling
From upstream / Qwen3.5 thinking defaults:
| Knob | Suggestion |
|---|---|
temperature |
0.6 tools/agentic · 1.0 open-ended |
top_p / top_k |
0.95 / 20 |
repetition_penalty |
1.05 |
max_tokens |
large (16k+) if thinking is on |
Rough M5 32GB (short prompts, thinking off): ~6 tok/s alone · ~8–11 tok/s with MTP.
Conversion
mlx_vlm.convert \
--hf-path /path/to/Qwythos-27B-v1 \
--mlx-path ./Qwythos-27B-MLX-VLM-4bit \
-q --q-bits 4 --dtype bfloat16 --trust-remote-code
Use mlx_vlm.convert, not mlx_lm.convert, if you need vision.
License & attribution
- Derived from empero-ai/Qwythos-27B-v1 (Apache-2.0), based on Qwen3.5-27B.
- Unofficial community MLX quant for Apple Silicon inference.
- Upstream is uncensored for technical/research use — add your own app-level controls.
Links
| MTP drafter | FancieF/Qwythos-27B-v1-MLX-MTP |
| BF16 MLX | FancieF/Qwythos-27B-v1-MLX-VLM-bf16 |
| Base | empero-ai/Qwythos-27B-v1 |
| GGUF | empero-ai/Qwythos-27B-v1-GGUF |
| ModelScope (ZH) | Fancie/Qwythos-27B-v1-MLX-VLM-4bit |
- Downloads last month
- 78
4-bit