Soracle is a parallelized extension of somax2. It preserves all features of Somax2 while introducing a new navigation model based on the factor oracle.
- macOS 10.13 or later / Windows 10+
- Max 8.5 or later
- Python > 3.9, < 3.12
Warning Python version: Soracle requires Python ≥3.10 and <3.12. Python 3.13 is not supported due to library incompatibilities (librosa). You can either use a virtual environment with Python 3.11, or configure your system so that python3 points to Python 3.11.
- Clone the master branch of this repository
- Add the
max/somaxsubfolder of Soracle to your Max path through Options -> File Preferences in Max. Make sure that thesubfoldersoption is checked.
- In a terminal, cd to the
Soracleroot folder and install the requirements withpip3 install -r python/somax/requirements.txt
The main Somax application is the patch soracle_tuto.maxpat. You can open this patch from inside Max or directly from Finder.
macOS: Note that the first time you launch Somax, depending on your security settings you may be presented with a number of dialogues asking you to give permission to a number of externals (shell, bonk, ircamdescriptor, bc.virfun and bc.yinstats) that Somax requires to be able to run. You may also be asked for permission the first time you launch the server (this step is explained in the tutorial). Accept each of those to proceed.
The document Documentation Soracle.pdf explains the model and how to use soracle.