aiexperiments-ai-duet

A piano that responds to you.

Go to file

Yotam Mann 5602b1ac88 updating splash links and style		2017-02-14 14:43:52 -05:00
server	backend uses attention_rnn now	2017-02-13 17:29:42 -05:00
static	updating splash links and style	2017-02-14 14:43:52 -05:00
.gitignore	adding readme / contributing	2016-11-11 13:52:40 -05:00
CONTRIBUTING.md	adding readme / contributing	2016-11-11 13:52:40 -05:00
Dockerfile	updating tf version	2017-01-13 17:52:22 -05:00
README.md	updated links to tf and magenta	2017-02-14 14:41:48 -05:00

README.md

A.I. Duet

A piano that responds to you.

About

This experiment lets you make music through machine learning. A neural network was trained on many MIDI examples and it learned about musical concepts, building a map of notes and timings. You just play a few notes, and see how the neural net responds.

https://aiexperiments.withgoogle.com/ai-duet

This is not an official Google product.

CREDITS

Built by Yotam Mann with friends on the Magenta and Creative Lab teams at Google. It uses TensorFlow, Tone.js and open-source tools from the Magenta project. Check out more at A.I. Experiments.

OVERVIEW

A.I. Duet is composed of two parts, the front-end which is in the static folder and the back-end which is in the server folder. The front-end client creates short MIDI files using the players's input which is sent to a Flask server. The server takes that MIDI input and "continues" it using Magenta and TensorFlow which is then returned back to the client.

INSTALLATION

A.I. Duet only works with Python 2.7. There are two basic ways of installing A.I. Duet: with Docker or without Docker.

If you already have a Python environment setup, install all of the server dependencies and start the server by typing the following in the terminal:

cd server
pip install -r requirements.txt

If this does not work, jump down to the Docker installation instructions, which will walk you through installing A.I. Duet within a Docker container.

If it did install tensorflow and magenta successfully, you can run the server by typing:

python server.py

Then to build and install the front-end Javascript code, first make sure you have Node.js 6 or above and webpack installed. And then install of the dependencies of the project and build the code by typing the following in the terminal:

cd static
npm install
webpack -p

You can now play with A.I. Duet at localhost:8080.

DOCKER

Docker is an open-source containerization software which simplifies installation across various OSes. It is the simplest method to build and install both the front-end and back-end components. Once you have Docker installed, you can just run:

$ sudo docker build -t ai-duet .
$ sudo docker run -t -p 8080:8080 ai-duet

You can now play with A.I. Duet at localhost:8080.

MIDI SUPPORT

The A.I. Duet supports MIDI keyboard input using Web Midi API and the WebMIDI library.

PIANO KEYBOARD

The piano can also be controlled from your computer keyboard thanks to Audiokeys. The center row of the keyboard is the white keys.

AUDIO SAMPLES

Multisampled piano from Salamander Grand Piano V3 by Alexander Holm (Creative Commons Attribution 3.0).

String sounds from MIDI.js Soundfonts generated from FluidR3_GM.sf2 (Creative Commons Attribution 3.0).

LICENSE

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.