Instructions to use divinetribe/AesCode-8B-MLX-4bit with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use divinetribe/AesCode-8B-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("divinetribe/AesCode-8B-MLX-4bit") config = load_config("divinetribe/AesCode-8B-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 divinetribe/AesCode-8B-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 "divinetribe/AesCode-8B-MLX-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": "divinetribe/AesCode-8B-MLX-4bit" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent
How to use divinetribe/AesCode-8B-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 "divinetribe/AesCode-8B-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 divinetribe/AesCode-8B-MLX-4bit
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use divinetribe/AesCode-8B-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 "divinetribe/AesCode-8B-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 "divinetribe/AesCode-8B-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"
AesCode-8B — Vision + Code (4-bit, MLX)
4-bit MLX quantization of Microsoft's AesCode-8B, with the vision tower kept intact so it reads a design or screenshot and writes the HTML/CSS back on Apple Silicon. 5.256 bits per weight (mixed; sensitive layers kept higher), 5.4 GB, two shards, group size 64.
4-bit is the smallest build, for 8 GB machines; the bf16 version is the full-quality one and the 8-bit version is the middle. This 4-bit build was put through the same pose-reading vision check as the others before publishing and still read the figure correctly, so the shrink held its sight.
AesCode generates information-rich visual artifacts (slides, posters, dashboards, reports) as structured, editable, verifiable HTML/CSS. It starts from Qwen3-VL-8B-Instruct and is trained with cold-start SFT followed by GDPO across seven reward channels, separating semantic requirements from visual cues through graph-structured supervision and decoupled cross-modal rewards.
What it is
- Base:
Qwen/Qwen3-VL-8B-Instruct(Qwen team). - Source checkpoint:
microsoft/AesCode-8B(Apache-2.0). - Architecture:
Qwen3VLForConditionalGeneration— aqwen3_vlvision tower feeding theqwen3_vl_textdecoder. 8.8B parameters. - This repo: 4-bit MLX weights (group size 64, mixed precision), vision kept, for
mlx-vlm. - Other sizes: bf16 (full quality) · 8-bit.
Running it (MLX)
from mlx_vlm import load, generate
from mlx_vlm.prompt_utils import apply_chat_template
model, processor = load("divinetribe/AesCode-8B-MLX-4bit")
prompt = apply_chat_template(processor, model.config,
"Rebuild this screenshot as a single HTML file.", num_images=1)
print(generate(model, processor, prompt, image=["design.png"], max_tokens=1024))
Text-only works with num_images=0 and no image= argument.
Worked vision example — pose-match QC
A real frame from a motion game (a translucent target avatar drawn over a live camera scene) was fed to this 4-bit model, asking whether the drawn figure is a correct human pose and whether any limbs are extra or wrong. The model's unedited on-device answer:
The translucent figure shows a humanoid pose. Arms are down by the sides, slightly bent at the elbows. Legs are straight with knees slightly bent, feet flat. The torso is upright. I don't see any extra limbs, crossed knees, or reversed joints. Overall, it resembles a neutral standing pose appropriate for a motion game target.
Even at 4-bit it is grounded in the actual pixels: it reads the translucency of the overlay, the single humanoid figure, the bent knees and flat feet, and it correctly answers the full QC question — no extra limbs, no crossed knees, no reversed joints — and even frames it as a motion-game target. Like the bf16 and 8-bit builds it placed the arms low rather than up in a full guard, so that is a trait of the model, not of the quantization. The same vision path that reads this frame also reads a design or screenshot and writes alt-text and the HTML/CSS back, which is what AesCode is built for.
Benchmarks
The single most reputable benchmark that genuinely applies is AesCode's own evaluation
from the paper (AesCode: Aesthetic Code Generation with Decoupled Cross-Modal Rewards,
arXiv:2610.18860): 300 infographic prompts scored on a
programmatic Rule track (Text, Bound, Chart) and a Visual checklist (Content, Layout,
Style), with Overall the mean of the two, averaged over three generations with no
selection. AesCode-8B reaches Overall 82.94 and Rule 90.07, improving Visual over its
reference-conditioned Qwen3-VL-8B backbone by 31.1 points; the paper reports this 8B
result exceeding the reference-conditioned GPT-5.5 (81.28) and Claude Opus 4.8 (80.39) rows
in the same table. 4-bit trades more accuracy for size, so expect the exact scores to move;
all numbers here are quoted from the AesCode paper and model card, not invented.
Credits
Enormous thanks to the people whose work this conversion simply repackages:
- The Microsoft AesCode authors — Xin Gao, Yifan Yang, Xin Li, Pan Wang, Yan Li, Muzhao Tian, Mingxi Cheng, Bei Liu, Kai Qiu, Qi Dai, Dong Chen, Yue Dong, Leandros Tassiulas, Rex Ying, Ji Li, and Chong Luo — who built and released AesCode-8B under Apache-2.0: model · paper · project page · code.
- The Qwen team at Alibaba — for the Qwen3-VL-8B-Instruct base and the Qwen3-VL vision-language architecture.
- Prince Canuma and the mlx-vlm project, and the Apple MLX team, for the tooling that makes vision-language models run natively on Apple Silicon.
The quantization to 4-bit MLX is the only work done here. All model quality is theirs.
Part of Claude Code Local
This model is one of the fighters in Claude Code Local (3.2k★), which runs Claude Code 100% on-device on Apple Silicon through an MLX-native Anthropic-API server. Not sure which local model to run as an agent? Check the Agent-12 local agent leaderboard: real agent tasks, judged by the filesystem, same hardware for every row.
Built by Matt Macosko in Humboldt, CA. Open to work on local-AI and Apple Silicon inference: matt@ineedhemp.com.
- Downloads last month
- 13
4-bit