explaingit

misfits-rebels-outcasts/mlxui

Analysis updated 2026-07-26

2SwiftAudience · generalComplexity · 2/5Setup · moderate

TLDR

A macOS app for running AI models locally on Apple Silicon. Browse, download, and chat with models without a terminal, Python, or API keys.

Mindmap

mindmap
  root((repo))
    What it does
      Runs local AI models
      No terminal needed
      Private offline
    Models
      28 curated models
      Chat and vision
      Speech and OCR
    Features
      Specialized interfaces
      Pipeline chaining
      RAM filter
    Tech stack
      Swift
      Apple MLX
      macOS 14
    Audience
      Mac users
      Privacy focused
      Non-technical

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 build with it?

USE CASE 1

Chat privately with AI models entirely offline on your Mac.

USE CASE 2

Transcribe audio to text and have an AI summarize it for you.

USE CASE 3

Upload an image and ask questions about what is in it.

USE CASE 4

Extract text from images using built-in OCR models.

What is it built with?

SwiftApple MLXmacOSXcode

How does it compare?

misfits-rebels-outcasts/mlxuiarpitbhalla/swift-appheymeco/mecoserial
Stars222
LanguageSwiftSwiftSwift
Last pushed2022-12-19
MaintenanceDormant
Setup difficultymoderatehardmoderate
Complexity2/52/53/5
Audiencegeneraldeveloperdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires an Apple Silicon Mac (M1 or later) running macOS 14.0 and Xcode 15.0 to build from source.

In plain English

MLXUI is a native macOS app that lets you run local AI models without touching a terminal or writing Python. It is built on Apple's MLX framework, which is designed specifically for Apple Silicon chips like the M1 and later. The app gives you a visual way to browse, download, and run AI models that live entirely on your Mac, with no data sent to external servers and no per-token pricing or API keys required. The app ships with a curated catalog of around 28 models across seven categories: chat and text, vision, OCR, speech-to-text, text-to-speech, and embeddings. These include familiar names like Llama, Qwen, Gemma, and Whisper. The catalog tracks roughly 435 models from the MLX community on Hugging Face, and new models are added with each release. You can browse by category, filter by what fits your Mac's RAM and chip bandwidth, and install with a single click that downloads the model directly from Hugging Face. Each model type gets its own dedicated interface rather than a generic wrapper. Chat models open a chat window. Speech-to-text models give you a microphone and a live transcript. Text-to-speech models offer a voice picker and an audio player. Vision models let you upload an image and ask questions about it. OCR models provide a drop area for images and show extracted text. A pipeline runner lets you chain models together, for example transcribing audio, summarizing the text, and then speaking the summary back. The codebase uses a module system where each model type lives in its own isolated folder. A contributor adding image generation support does not need to understand the chat pipeline, and updating one speech module never touches another. The app is built in Swift and requires macOS 14.0 or later, an Apple Silicon Mac, and Xcode 15.0 or later to build from source. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Help me build a new MLXUI module for image generation. Walk me through the folder structure and how to create an isolated module that follows the existing pattern.
Prompt 2
I want to chain a speech-to-text model, a summarization chat model, and a text-to-speech model using the MLXUI pipeline runner. Help me write the pipeline configuration.
Prompt 3
Explain how to add a new model from Hugging Face to the MLXUI catalog, including how to categorize it and set the RAM and chip bandwidth filters.
Prompt 4
I am getting a build error in Xcode trying to compile MLXUI. My macOS is 13.5 and Xcode is 14. What are the exact minimum requirements to build this app?

Frequently asked questions

What is mlxui?

A macOS app for running AI models locally on Apple Silicon. Browse, download, and chat with models without a terminal, Python, or API keys.

What language is mlxui written in?

Mainly Swift. The stack also includes Swift, Apple MLX, macOS.

How hard is mlxui to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is mlxui for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.