Skip to main content

Magenta RealTime 2

CLI Tests

Magenta RealTime 2 (MRT2) is a state-of-the-art open-weights model for real-time music generation. It contains several key components

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)

Source distribution for magenta-rt 2.0.3
File Size Uploaded Provenance
magenta_rt-2.0.3.tar.gz 1.3 MB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for magenta-rt 2.0.3
File Interpreter ABI Platform
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 log

Release 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 log

Security 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.

Select from 2 files

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 log

A 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.

Release history Release notifications | RSS feed

This release

2.0.3 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page