whatisgithub

What is nemotron-twotower-mlx?

pipenetwork/nemotron-twotower-mlx — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · researcherComplexity · 5/5Setup · hard

In one sentence

A project that lets NVIDIA's large Nemotron TwoTower diffusion language model run natively on Apple Silicon Macs using the MLX framework.

Mindmap

mindmap
  root((nemotron-twotower-mlx))
    What it does
      Runs Nemotron model on Mac
      Mask diffusion generation
      Uses MLX framework
    Tech stack
      Python
      MLX
      Apple Silicon
      Hugging Face
    Use cases
      Local AI on Mac
      Diffusion text research
      Speed comparisons
    Options
      4-bit quant
      6-bit quant
      8-bit quant
      bf16 full precision

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

Run a large NVIDIA diffusion language model locally on an Apple Silicon Mac without needing an NVIDIA GPU.

USE CASE 2

Experiment with mask-diffusion text generation as an alternative to standard left-to-right generation.

USE CASE 3

Compare generation speed and memory use across different quantization levels on Apple hardware.

USE CASE 4

Use the smaller autoregressive tower alone as a lighter, ordinary text generation model.

What is it built with?

PythonMLXApple SiliconHugging Face

How does it compare?

pipenetwork/nemotron-twotower-mlx0xhassaan/nn-from-scratch3ks/embedoc
Stars00
LanguagePythonPythonPython
Last pushed2023-06-08
MaintenanceDormant
Setup difficultyhardmoderatehard
Complexity5/54/51/5
Audienceresearcherdeveloperdeveloper

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

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires an Apple Silicon Mac with enough unified memory to hold the chosen model size, up to 128GB for the full precision version.

Distributed under an NVIDIA Open Model license as stated by the badge in the README.

So what is it?

This project lets you run a large NVIDIA AI language model called Nemotron TwoTower on Apple computers with M-series chips, using a framework called MLX that Apple built for running machine learning on its own hardware. Normally this kind of large model would need an NVIDIA graphics card and specialized software, but this repo converts and adapts it to run natively on a Mac instead. What makes this particular model unusual is how it generates text. Most AI language models write one word at a time, left to right. This one uses a technique the author calls mask diffusion, where a block of upcoming words starts out completely hidden or masked, and the model gradually fills in and refines those words over several passes until it is confident enough to commit to them, then moves on to the next block. The repo actually offers two related things: a standard, ordinary text generation model that works out of the box with existing Mac AI tools, and the fuller two tower diffusion version that needs this repo's own code to run. The model comes in several size and precision options, from a smaller compressed 4-bit version up to a larger, more precise but much heavier bf16 version, with memory requirements ranging from about 17 gigabytes up to around 118 gigabytes depending on the version and precision chosen. Which one you can run depends on how much memory your Mac has. The README recommends starting with the smallest 4-bit versions if you are unsure. Getting started involves having a Mac with Apple Silicon, Python 3.9 or newer, cloning the repository, and installing the listed Python packages. The author reports that the converted model produces identical output, token for token, compared to running the original model on NVIDIA hardware, and provides speed benchmarks measured on a high-end Mac Studio showing how many words per second each version can generate.

Copy-paste prompts

Prompt 1
Explain in simple terms how mask diffusion text generation differs from normal left to right generation, based on this project.
Prompt 2
Walk me through installing nemotron-twotower-mlx and running the smallest 4-bit autoregressive model on my Mac.
Prompt 3
How much RAM would I need to run the full TwoTower diffusion model at 6-bit precision on this project?
Prompt 4
What do the block-size and steps-per-block settings control when generating text with this repo's diffusion model?

Frequently asked questions

What is nemotron-twotower-mlx?

A project that lets NVIDIA's large Nemotron TwoTower diffusion language model run natively on Apple Silicon Macs using the MLX framework.

What language is nemotron-twotower-mlx written in?

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

What license does nemotron-twotower-mlx use?

Distributed under an NVIDIA Open Model license as stated by the badge in the README.

How hard is nemotron-twotower-mlx to set up?

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

Who is nemotron-twotower-mlx for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.