Instructions to use runanywhere/Fara1.5-4B-mlx-4bit with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use runanywhere/Fara1.5-4B-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("runanywhere/Fara1.5-4B-mlx-4bit") config = load_config("runanywhere/Fara1.5-4B-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 runanywhere/Fara1.5-4B-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 "runanywhere/Fara1.5-4B-mlx-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": "runanywhere/Fara1.5-4B-mlx-4bit" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use runanywhere/Fara1.5-4B-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 "runanywhere/Fara1.5-4B-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 runanywhere/Fara1.5-4B-mlx-4bit
Run Hermes
hermes
- OpenClaw new
How to use runanywhere/Fara1.5-4B-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 "runanywhere/Fara1.5-4B-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 "runanywhere/Fara1.5-4B-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"
Fara1.5-4B — MLX 4-bit
An Apple MLX 4-bit conversion of
microsoft/Fara1.5-4B, Microsoft AI
Frontiers' agentic Computer-Use Agent (CUA) for web browsers, built on the Qwen3.5-VL
architecture (model_type: qwen3_5 / qwen3_5_vision).
This repository only re-packages Microsoft's model for on-device Apple-silicon inference. All model capabilities, training, and credit belong to Microsoft AI Frontiers. Original model, full system prompt, and the MagenticLite agent scaffold: https://huggingface.co/microsoft/Fara1.5-4B and https://github.com/microsoft/fara.
What this is
- Format: MLX, 4-bit (
affine, group size 64). The vision tower is kept at full precision (bf16) — only the language-model layers are quantized — so visual grounding is not degraded by quantization. - Size: ~3.7 GB (vs ~8 GB bf16).
- Converted with
mlx-vlm0.6.6:python -m mlx_vlm convert --hf-path microsoft/Fara1.5-4B \ --mlx-path Fara1.5-4B-mlx-4bit -q
Usage
Loads through MLX VLM stacks that support qwen3_5 (e.g. mlx-vlm, and
mlx-swift-lm's Qwen35 VLM class) with no code changes.
python -m mlx_vlm generate --model runanywhere/Fara1.5-4B-mlx-4bit \
--image screenshot.png --system "$FARA_SYSTEM_PROMPT" \
--prompt "Book a table for 2 at a sushi place in Sunnyvale for Friday 7pm." \
--temperature 0.0 --max-tokens 1024
Fara is a web-browser agent. To drive it correctly, use Microsoft's contract
(see the base model / microsoft/fara):
- Provide the full system prompt including the
computer_usetool schema inside<tools></tools>— without it the model cannot reliably emit valid tool-calls. - The model emits actions as
<tool_call>{"name": "computer_use", "arguments": {...}}</tool_call>. - Coordinates are returned in a fixed 1000×1000 space; scale to your viewport
(e.g.
x*1.44, y*0.9for a 1440×900 window). 1440×900 is the recommended capture size. - The reference agent loop, safety "critical points", and sandboxing live in MagenticLite.
Validation
Verified running through the Apple MLX runtime (Python mlx-vlm and Swift mlx-swift-lm).
On a small suite of real 1440×900 browser screenshots with Fara's exact CUA prompt, this
4-bit conversion produced valid left_click tool-calls and grounded coordinates that
were near-identical (within ~0.1–0.3%) to the full-precision f32 reference on every
task, missing the same targets with the same coordinates — i.e. the quantization is
essentially lossless; any grounding errors are the base model's own behavior, not an
artifact of this conversion.
License
MIT, inherited from microsoft/Fara1.5-4B. Please review Microsoft's model card for intended use, limitations, and responsible-AI guidance (Fara is trained to pause at safety-critical points; keep a human in the loop for irreversible actions).
- Downloads last month
- -
4-bit