Skip to main content
AI Tool Radar
OSI-openLocal inference and "what runs on my machine"

mlx-tune

ARahim3

Unsloth-compatible fine-tuning for LLMs, VLMs, TTS and STT on Apple Silicon via MLX.

1.3k stars(as of 2026-06-14)View on GitHubHomepage

What is mlx-tune?

mlx-tune wraps Apple's MLX with an API intentionally compatible with Unsloth (the popular CUDA fine-tuner), letting Mac users run SFT, DPO, GRPO, vision-model training and TTS/STT fine-tuning locally on unified memory. Ships 50+ examples and 39+ supported model architectures including MoE.

mlx-tune in depth

Fine-tuning large language models has long been tied to NVIDIA hardware. The popular tooling, including Unsloth, assumes CUDA, so anyone working on a Mac is locked out of running experiments locally and has to rent cloud GPUs even for small jobs. mlx-tune, built by ARahim3, addresses that gap. It wraps Apple's MLX framework in an API that is intentionally compatible with Unsloth, the widely used CUDA fine-tuner. The goal is portability: write FastLanguageModel code once on an Apple Silicon Mac, test it locally, then push the same script to a CUDA cluster for production training. It is not pitched as a replacement for Unsloth, which the project itself calls the gold standard, but as a bridge for Mac users who want to prototype before scaling.

mlx-tune sits on top of MLX, Apple's array framework that runs on the GPU and Neural Engine of Apple Silicon. The distinctive part is the unified memory architecture: instead of being limited by discrete GPU VRAM, the chip shares one memory pool, which on a Mac Studio can reach up to 512GB. That lets you load and fine-tune models that would not fit on a typical consumer NVIDIA card. The library mirrors Unsloth's surface so migration is mostly a matter of swapping import statements. It covers a broad set of methods: SFT, DPO, ORPO, GRPO, KTO and SimPO for preference and reinforcement style tuning, plus continual pretraining and Mixture of Experts training. Support extends beyond text to vision-language models, TTS, STT, embeddings and OCR, with 39+ architectures listed.

The clearest fit is the practitioner who develops on a Mac and wants to stay in the Apple ecosystem for small runs. A researcher can debug a DPO loop on a laptop without spinning up cloud infrastructure, then move the validated script to rented GPUs once it works. The Unsloth-compatible API makes that round trip realistic rather than a rewrite. The breadth is also useful for people exploring more than plain text models: someone fine-tuning a Whisper variant for STT, a PaliGemma style vision model, or an embedding model can do it from one library on the same machine. The project ships 50+ examples, which lowers the barrier for first runs. For teaching, hobby projects and early feasibility checks on a well-specced Mac, it is a genuinely practical option.

The constraints are real and worth stating plainly. mlx-tune is Apple Silicon only, so there is no path to the CUDA servers where most production training actually runs. The bridge metaphor only works one way: you prototype on Mac, then deploy elsewhere. The community is still early, which means few battle-tested failure reports and limited independent confirmation that complex runs reproduce cleanly. Performance figures are self-reported. The v0.5.0 notes claim, on an M4 Pro, that GRPO runs roughly 10x faster and embedding fine-tuning about 1.8x faster, but these are the project's own numbers without third-party benchmarks. There are concrete rough edges too: GGUF export from quantized 4-bit base models does not work because of mlx-lm constraints, and DeepSeek-OCR support needs transformers below 5.0 plus manual dependency installation.

Against its commercial-grade alternatives, Unsloth on rented GPUs or a platform like Modal, mlx-tune occupies a narrow but real niche. It does not compete on scale or on reproducibility against the CUDA stack that the rest of the field standardizes on. What it offers is local iteration without cloud cost and without leaving your Mac, plus an API designed so the work transfers. Adopt it if you prototype fine-tuned models on Apple Silicon, run small experiments, and value staying local for the early loop. Treat it as too early if you need training at scale, must reproduce results on CUDA hardware, or cannot tolerate the missing pieces like quantized GGUF export. For Mac-based experimentation it is worth a serious look; for production, plan to graduate to the CUDA path it is built to feed.

Pros & Cons

Pros

  • Unsloth-compatible API lowers migration friction from CUDA fine-tuning workflows
  • Apple Silicon unified memory allows fine-tuning larger models locally than typical VRAM permits (project's own claim)
  • Covers LLM, VLM, TTS, STT and embeddings from one library

Cons

  • Apple Silicon only - no path to CUDA servers where most production training runs
  • Early community (few battle-tested failure reports)
  • Performance figures are self-reported

License

Apache-2.0 (OSI-open)

When it is interesting

Practitioners who prototype fine-tuned models on a Mac and want to stay in the Apple ecosystem for small runs.

When it is too early

If you need training at scale or must reproduce results on CUDA hardware.

Commercial alternative & related

  • Commercial counterpart: Unsloth / Modal

This repo featured in the 2026-07 edition of the Open-Source AI Radar.