Skip to content
Magenta: Music and Art Generation with Machine Intelligence
Branch: master
Clone or download
jesseengel and Copybara-Service Fix semisupervised data pipeline by passing label_ratio to _parse().
PiperOrigin-RevId: 244430969
Latest commit 3b55374 Apr 20, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
demos Move demos and to top level of repo. Jan 18, 2019
.gitignore GANSynth (#1404) Jan 18, 2019
.isort.cfg internal Jan 23, 2019
.travis.yml Allow internal presubmits. Jan 24, 2019
AUTHORS RL tuner (#339) Nov 9, 2016
LICENSE Adding a LICENSE file (Apache 2.0) May 5, 2016 Remove support for the Magenta Docker container. Apr 19, 2019 Lock pylint and astroid at previous versions to avoid spurious errors. Mar 1, 2019
magenta-logo-bg.png Minor README updates. (#467) Dec 16, 2016
setup.cfg Lock pylint and astroid at previous versions to avoid spurious errors. Mar 1, 2019 Remove upper bound on numpy version dependency. This causes pylint co… Mar 14, 2019

Build Status PyPI version

Magenta is a research project exploring the role of machine learning in the process of creating art and music. Primarily this involves developing new deep learning and reinforcement learning algorithms for generating songs, images, drawings, and other materials. But it's also an exploration in building smart tools and interfaces that allow artists and musicians to extend (not replace!) their processes using these models. Magenta was started by some researchers and engineers from the Google Brain team, but many others have contributed significantly to the project. We use TensorFlow and release our models and tools in open source on this GitHub. If you’d like to learn more about Magenta, check out our blog, where we post technical details. You can also join our discussion group.

This is the home for our Python TensorFlow library. To use our models in the browser with TensorFlow.js, head to the Magenta.js repository.

Getting Started


Magenta maintains a pip package for easy installation. We recommend using Anaconda to install it, but it can work in any standard Python environment. We support both Python 2 (>= 2.7) and Python 3 (>= 3.5). These instructions will assume you are using Anaconda.

Note that if you want to enable GPU support, you should follow the GPU Installation instructions below.

Automated Install (w/ Anaconda)

If you are running Mac OS X or Ubuntu, you can try using our automated installation script. Just paste the following command into your terminal.

curl > /tmp/
bash /tmp/

After the script completes, open a new terminal window so the environment variable changes take effect.

The Magenta libraries are now available for use within Python programs and Jupyter notebooks, and the Magenta scripts are installed in your path!

Note that you will need to run source activate magenta to use Magenta every time you open a new terminal window.

Manual Install (w/o Anaconda)

If the automated script fails for any reason, or you'd prefer to install by hand, do the following steps.

Install the Magenta pip package:

pip install magenta

NOTE: In order to install the rtmidi package that we depend on, you may need to install headers for some sound libraries. On Linux, this command should install the necessary packages:

sudo apt-get install build-essential libasound2-dev libjack-dev

The Magenta libraries are now available for use within Python programs and Jupyter notebooks, and the Magenta scripts are installed in your path!

GPU Installation

If you have a GPU installed and you want Magenta to use it, you will need to follow the Manual Install instructions, but with a few modifications.

First, make sure your system meets the requirements to run tensorflow with GPU support.

Next, follow the Manual Install instructions, but install the magenta-gpu package instead of the magenta package:

pip install magenta-gpu

The only difference between the two packages is that magenta-gpu depends on tensorflow-gpu instead of tensorflow.

Magenta should now have access to your GPU.

Using Magenta

You can now train our various models and use them to generate music, audio, and images. You can find instructions for each of the models by exploring the models directory.

To get started, create your own melodies with TensorFlow using one of the various configurations of our Melody RNN model; a recurrent neural network for predicting melodies.

Playing a MIDI Instrument

After you've trained one of the models above, you can use our MIDI interface to play with it interactively.

We also have created several demos that provide a UI for this interface, making it easier to use (e.g., the browser-based AI Jam).

Development Environment

If you want to develop on Magenta, you'll need to set up the full Development Environment.

First, clone this repository:

git clone

Next, install the dependencies by changing to the base directory and executing the setup command:

python develop

You can now edit the files and run scripts by calling Python as usual. For example, this is how you would run the melody_rnn_generate script from the base directory:

python magenta/models/melody_rnn/melody_rnn_generate --config=...

You can also install the (potentially modified) package with:

python install

Before creating a pull request, please also test your changes with:

python test

PIP Release

To build a new version for pip, bump the version and then run:

python test
python bdist_wheel --universal
python bdist_wheel --universal --gpu
twine upload dist/magenta-N.N.N-py2.py3-none-any.whl
twine upload dist/magenta_gpu-N.N.N-py2.py3-none-any.whl
You can’t perform that action at this time.