tidal-bootstrap is an interactive python script which attempts to automate the installation process of the TidalCycles programming environment on macOS.

Important notice

Some users have reported issues using this script with newer versions of macOS, see this thread for the whole discussion. The solution is to install the haskell platform manually and then run this script to install the rest of the dependencies.

Please report any issues here


  1. If you don't have homebrew you first need to install it. Follow the instructions on the homebrew page.

    If you are not sure if you have homebrew or not, open up a Terminal (Spotlight -> Terminal) and type: which brew if nothing happens you don't have homebrew and need to install it.

  2. Download the zip file from this page and extract it somewhere (like your desktop)

  3. Open the folder and double-click on the file tidal-bootstrap.command, a Terminal window will pop up and you will get further instructions.

  4. Go make some music with TidalCycles :)