Magenta RealTime 2
Magenta RealTime 2 (MRT2) is a state-of-the-art open-weights model for real-time music generation. It contains several key components
- An open-weights model
- A Python library
magenta-rtfor inference with JAX and MLX backends - A C++ inference engine
magentart::corefor efficient streaming audio generation on Apple Silicon MacBooks - A suite of example applications built on the inference engine.
Use this project to run inference, build a DAW plugin, or embed the model into new applications of your imagination. Future updates will support supervised fine-tuning.
📖 Full documentation: https://magenta.github.io/magenta-realtime/
(or build it locally — see docs/README.md).
Repo Highlights
magenta_rt/— Python inference library (JAX / MLX backends).core/— C++ inference library (magentart::core).examples/mrt2/auv3— All-in-one AUv3 plugin for DAWs.examples/mrt2/standalone— All-in-one standalone macOS app.examples/jam/— App for exploring note control.examples/collider/— App for exploring prompt space.notebooks/- Notebook for trying Python API.
Hardware requirements
Real-time streaming requires Apple Silicon (M-series). We offer two model sizes:
mrt2_small(230M parameters) — runs real-time on any Apple Silicon Mac, including Air models.mrt2_base(2.4B parameters) — higher quality; requires a Pro Max chip for real-time streaming.
The table below shows which devices support real-time streaming (generating audio faster than playback):
| Device | mrt2_small (230M) |
mrt2_base (2.4B) |
|---|---|---|
| M5 Max | ✅ | ✅ |
| M3 Max | ✅ | ✅ |
| M2 Max | ✅ | ✅ |
| M4 Pro | ✅ | ✅ |
| M2 Pro | ✅ | ❌ |
| M1 Pro | ✅ | ❌ |
| M4 Air | ✅ | ❌ |
| M3 Air | ✅ | ❌ |
| M1 Air | ✅ | ❌ |
Note: Both models can also run offline (non-real-time) inference on any Apple Silicon Mac or NVIDIA GPU via the Python library. See more details on
docs/models.md.
Quickstart on Apple Silicon
# Install uv if you haven't and create a venv
curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv --python 3.12
source .venv/bin/activate
# Install dependencies (Python dev)
uv pip install "magenta-rt[mlx]"
# Download resources: style model and codec model
# (i.e., MusicCoCa and SpectroStream)
mrt models init
# Download the streaming model you want to use
mrt models download
# Generate 4 seconds of music (change to `mrt2_small` for small model)
mrt mlx generate --prompt "disco funk" --duration 4.0 --model=mrt2_base
Python Development
For local development, clone the repo instead of installing from PyPI:
git clone --recurse-submodules https://github.com/magenta/magenta-realtime.git
cd magenta-realtime
uv pip install -e ".[mlx]"
C++ App Development
To get started building C++ apps, perform the following setup:
# Install dependencies
uv pip install "cmake<3.28"
# Build hello_mrt2 (a basic command-line interface)
cmake . -B build
cmake --build build --target hello_mrt2 -j10
# Generate 4 seconds of music
./build/examples/hello_mrt2/hello_mrt2 \
~/Documents/Magenta/magenta-rt-v2/models/mrt2_base/mrt2_base.mlxfn \
~/Documents/Magenta/magenta-rt-v2/resources \
100 \
--prompt "ambient pads with sub bass"
See the full documentation:
Other resources
Citing this work
Please cite our previous technical report:
BibTeX:
@article{gdmlyria2025live,
title={Live Music Models},
author={Caillon, Antoine and McWilliams, Brian and Tarakajian, Cassie and Simon, Ian and Manco, Ilaria and Engel, Jesse and Constant, Noah and Li, Pen and Denk, Timo I. and Lalama, Alberto and Agostinelli, Andrea and Huang, Anna and Manilow, Ethan and Brower, George and Erdogan, Hakan and Lei, Heidi and Rolnick, Itai and Grishchenko, Ivan and Orsini, Manu and Kastelic, Matej and Zuluaga, Mauricio and Verzetti, Mauro and Dooley, Michael and Skopek, Ondrej and Ferrer, Rafael and Borsos, Zal{\'a}n and van den Oord, {\"A}aron and Eck, Douglas and Collins, Eli and Baldridge, Jason and Hume, Tom and Donahue, Chris and Han, Kehang and Roberts, Adam},
journal={arXiv:2508.04651},
year={2025}
}
Metadata
Release files for magenta-rt 2.0.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| magenta_rt-2.0.3.tar.gz | 1.3 MB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| magenta_rt-2.0.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.7 MB
Release files / magenta_rt-2.0.3.tar.gz
| Download URL | magenta_rt-2.0.3.tar.gz |
|---|---|
| Size | 1.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
40081f78bf13cd9a7f754e9712060b5f3af8ea778fb6d73e023daac34a7b3bf9
|
|
BLAKE2b-256 checksum How to use checksums |
3d6d0a9cd7e4ae3e9ddb28d72b3816d74a744ea46bc0a346d3e5663f21a37867
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 30, 2026.
Transparency logRelease files / magenta_rt-2.0.3-py3-none-any.whl
| Download URL | magenta_rt-2.0.3-py3-none-any.whl |
|---|---|
| Size | 1.4 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
02ccf9714713dd7df43b9f15c534a0db0e5991a48cb63a83a00654676d85be74
|
|
BLAKE2b-256 checksum How to use checksums |
e35601a07fa38210e784af83ed177ca93b11f4df00c65999df099be2a797f91f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 30, 2026.
Transparency logSecurity for magenta-rt 2.0.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for magenta_rt-2.0.3.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 30, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.