/unloop

a co-creative looper that uses generative modeling to **not** repeat itself.

Primary LanguageMaxMIT LicenseMIT

unloop

unloop is a co-creative looper that uses generative modeling to not repeat itself.

watch a demo video here: https://youtu.be/yzBI8Vcjd2s.

unlooper leverages the power of VampNet, a masked generative model for music, to generate variations of loop a musician has recorded, creating a more interactive and fun experience than using a traditional looper.

Setup

unloop is a Max patch, but it requires python to contact the huggingface space that hosts the VampNet model to generate the variations.

you will need to install the following max externals s well: karma and shell.

First, clone the repo

git clone https://github.com/hugofloresgarcia/unloop.git
cd unloop

unloop requires Python 3 to be installed on your computer.

Then, install the local python package called vamp.

python -m pip install -e .

You'll need to keep track of where your python installation is, so copy the output of the following command:

which python

Your python path will look like this: /some/path/to/bin/python.

Usage

unloop is a Max patch, meaning that you'll need to open it using Max MSP.

to open unloop, simply open unloop.maxpat using Max.

NOTE: you'll need to know the path to the Python installation where you installed the vamp package. You'll need to enter this path in the max patch.

python-path

Once you've done this, you're all set! Refer to the demo video for a usage example.