git404hub

what is qmlx fr?

marzukia/qmlx — explained in plain English

Analysis updated 2026-05-18

28PythonAudience · developerComplexity · 5/5Setup · hard

tl;dr

A specialized engine that keeps long AI conversations fast on Apple Silicon Macs by saving conversation state to disk.

vibe map

mindmap
  root((qMLX))
    What it does
      Serves Qwen3.5-122B
      Disk based KV cache
      Speeds up long chats
    Tech stack
      Python
      MLX framework
      Apple Silicon
    Use cases
      Serve large models locally
      Restore chat state fast
      Run on Mac Studio
    Audience
      Developers
      ML engineers
    Status
      Alpha stage
      Single model focus
      Single user only

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Serve the Qwen3.5-122B language model efficiently on a Mac Studio.

VIBE 2

Keep long, multi-turn AI conversations fast by restoring saved state from disk instead of reprocessing.

VIBE 3

Run large hybrid language models on Apple Silicon without needing cloud GPUs.

what's the stack?

PythonMLXApple Silicon

how it stacks up fr

marzukia/qmlxademola-lou/threejsgnmalicankiraz1/codexqb
Stars282828
LanguagePythonPythonPython
Setup difficultyhardmoderateeasy
Complexity5/53/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · hard time til it works · 1h+

Requires an Apple Silicon Mac with 96GB or more of unified memory and a large model download.

in plain english

qMLX is a specialized serving engine for running a very large AI language model, Qwen3.5 122B, on Apple Silicon Macs like the Mac Studio. It is a fork of an existing project called Rapid-MLX, rebuilt specifically around one model and one problem: keeping long conversations fast to respond to. This particular model is a hybrid, meaning most of its internal layers work in a way that cannot simply be paused and resumed from memory the way normal attention layers can. Because of that, the usual trick of keeping recent conversation state in memory does not work here at all, so the project relies entirely on saving that state to the computer's disk and reading it back for the next message in a conversation. The README says this is not a backup plan, it is the only mechanism that makes the cache work for this model. The payoff is significant: a repeated 32,000 word prompt that would normally take 88 seconds to reprocess can be restored in under a second instead. The project includes disk-based saving and restoring of conversation state, a way to decide which saved state to delete first when disk space runs low, honest performance measurements that do not exaggerate speed, and logging that helps pinpoint exactly where a cached conversation stopped matching. The project is explicitly built only for Apple Silicon Macs with a lot of unified memory, only for this one AI model for now, and only for a single user at a time, not many people using it simultaneously. The project is labeled alpha stage, meaning it is early and specialized rather than broadly tested. One known limitation is that if a long response gets interrupted partway through, that work is thrown away and has to start over from scratch next time. A fix for that is planned but not yet built. Installation is done through Python's package tools, either from a package registry or by cloning the project's source code directly. Once installed, it exposes an interface compatible with the same style of API used by OpenAI and Anthropic. The README does not mention a license.

prompts (copy fr)

prompt 1
Walk me through installing and serving Qwen3.5-122B with qMLX on my Mac Studio.
prompt 2
Explain why qMLX relies on disk caching instead of in-memory caching for this model.
prompt 3
Help me tune the QMLX_KV_CHECKPOINT_MAX_BYTES setting for my available disk space.
prompt 4
What sampling settings does qMLX recommend for Qwen3.5-122B?

Frequently asked questions

what is qmlx fr?

A specialized engine that keeps long AI conversations fast on Apple Silicon Macs by saving conversation state to disk.

What language is qmlx written in?

Mainly Python. The stack also includes Python, MLX, Apple Silicon.

How hard is qmlx to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is qmlx for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.