Releases: DYCI2/Dicy2
Dicy2 3.0: Dicy2 for Max & Ableton Live !
Brand new version of Dicy2 for Max implemented as a modular library !
Dicy2 for Max (formerly DYCI2) is a Max package implementing interactive agents using machine-learning to generate musical sequences that can be integrated into musical situations ranging from the production of structured material within a compositional process to the design of autonomous agents for improvised interaction. Check also our plugin for Ableton Live !
To discuss Dicy2 for Max features, use the Forum discussion groups at https://discussion.forum.ircam.fr/c/dicy2/
Getting Started
Requirements
- Mac OS >= High Sierra
- Max 8
Standard installation
- Download the last Dicy2 release.
- Drag the Dicy2 directory in your Max packages.
- Install the dependency "MuBu for Max" >=1.10.5 from the Ircam Forum Webpage.
RELEASE NOTE: The current release of Dicy2 has been tested with MuBu v1.10.5 which can be found here in case of hypothetical problems with a later version installed from the Package Manager. Dicy2 will of course be tested and updated along with the various MuBu releases.
Quick Start
- See the "Dyci2 for Max user guide" that comes with the library.
- Have a look at "extras/Dicy2_Overview.maxpat"
- Tutorials and examples are in "examples" and "examples/Performance Strategies"
- Video tutorial on Ircam's Youtube channel
About Dicy2
Some references
If using Dicy2, please quote:
Nika, J., Muller, A., Borg, J., Ostrowski, M., & Assayag, G. (2022, December). Dicy2 for Max. Ircam. 2022 or Nika, J., Déguernel, K., Chemla, A., Vincent, E., & Assayag, G. (2017, October). Dyci2 agents: merging the" free"," reactive", and" scenario-based" music generation paradigms. In International Computer Music Conference. (Article).
Artistic collaborations
Dicy2 integrates scientific and musical research results accumulated through productions and experiments with Rémi Fox, Steve Lehman, the Orchestre National de Jazz, Alexandros Markeas, Pascal Dusapin, Le Fresnoy - Studio National des Arts Contemporains, Vir Andres Hera, Gaëtan Robillard, Benoît Delbecq, Jozef Dumoulin, Ashley Slater, Hervé Sellin, Rodolphe Burger, Marta Gentilucci... After having evolved research prototypes crystallizing the contributions of these various projects for several years, a collaborative work carried out during the year 2022 has led to the finalization of a release of Dicy2 as a plugin for Ableton Live and a library for Max.
Dicy2 tutorials and examples
This distribution includes agents and sound files from past productions with our friends and collaborating musicians and composers who helped bring Dicy2 to life (courtesy of the artists). Please do not use these agents and files in any context other than these tutorials to respect their work and generosity.
"Doublebass_Perrot_Fox.wav, Guitar_Caillou_Fox.wav, and Voice_Daumergue_Fox.wav" were respectively recorded by Alex Perrot, Thomas Caillou, and Manu Daumergue during Rémi Fox's residency at Ircam for the concerts and first album of "C'est pour ça".
"Balafon_Lehman_ExMachina.wav" and "SaxPlayingMode_Lehman_ExMachina.wav" were recorded by Steve Lehman for "Ex Machina" with Orchestre National de Jazz.
"Texture_Maurin_ExMachina.wav" was recorded by Fred Maurin for "Ex Machina" with Orchestre National de Jazz.
"Piano_Markeas_Music-Of-Choices.wav" was recorded by Alexandros Markeas for "Music of Choices".
"Soprano_Gentilucci.wav" was recorded by Marta Gentilucci during her residency "Female Singing Voice's Vibrato and Tremolo: Analysis, Mapping and Improvisation" at Ircam.
"Fox_Sax_1/2/3.aif" comes from a performance of "C'est pour ça" at Ircam.
"Nox3_LucidDreams.wav" comes from the song "Lucid Dreams" by Nox3.
Authors
Dicy2 is a library of the Ircam Musical Representations team, designed and developed by Jérôme Nika, Augustin Muller (Max library), Joakim Borg (Python generative engine / Gig RepMus API), and Matthew Ostrowski (tutorial patchers and videos, abstractions) in the framework of the projects ANR-DYCI2, ANR-MERCI, ERC-REACH directed by Gérard Assayag, and the UPI-CompAI Ircam project.
The audio use cases have been designed and developed with Diemo Schwarz and Riccardo Borghesi, and use the MuBu and CataRT environments of the ISMM team of Ircam. Max4Live plugin by Manuel Poletti.
Contributions / thanks : Serge Lemouton, Jean Bresson, Thibaut Carpentier, Georges Bloch, Mikhaïl Malt, Axel Chemla--Romeu-Santos, Tristan Carsault, Vincent Cusson, Tommy Davis, Dionysios Papanicolaou, Greg Beller, Markus Noisternig.
More
Contact us
Please write to jerome.nika@ircam.fr
and augustin.muller@ircam.fr
for any question, or to share with us your projects using Dicy2 !
License
GPL v3
DYCI2 1.0 --> This release is not a release.
Brand new version coming very soon !
This upload brings minor fixes to the previous release...
... but we rather recommend you to be patient because a brand new version of DYCI2 will be released within a month!
Real modular library, tutorials, videos, and Max4Live device... Stay tuned!
DYCI2_library
The DYCI2 library contains a collection of generative agents and tools for human-machine live interaction. It integrates the results of the DYCI2 project and shapes a next-generation software with regard to OMax.
If using the library, please quote: Nika, J., Déguernel, K., Chemla, A., Vincent, E., & Assayag, G. (2017, October). Dyci2 agents: merging the" free"," reactive", and" scenario-based" music generation paradigms. In International Computer Music Conference. (Article).
Some videos of artistic productions using DYCI2 or its previous versions: https://www.youtube.com/channel/UCAKZIW0mMWCrX80yS96ZxAw.
A recent presentation about the DYCI2 library (20 min in english): https://youtu.be/RXKJbpJb8w4?t=1530
Author: Jérôme Nika (IRCAM STMS LAB) ; Contributors: Joakim Borg (IRCAM STMS LAB), Ken Déguernel (IRCAM STMS LAB / Inria Nancy - Grand Est), Axel Chemla--Romeu-Santos (IRCAM STMS LAB), Georges Bloch (UniStra), Diemo Schwarz (IRCAM STMS LAB); DYCI2 research project : Gérard Assayag (Ircam, PI), Emmanuel Vincent (Inria Nancy, WP leader), Jérôme Nika (Ircam, WP coordinator), Marc Chemillier (EHESS, associate researcher).
This folder contains a release version of DYCI2lib ready to be used as a Max library (the corresponding development repository and the Python code are available here: https://github.com/DYCI2/Dyci2Lib).
Check also om-dyci2, the "offline" compositional declination of this project, a framework for interactive generation of musical sequences combining generative agents and computer-assisted composition tools.
Release
NEW:
- Application built from the Python code --> No need to use Python anymore (see below: one version for OS >= High Sierra and < Catalina, one version for OS >= Catalina)
- New tutos
- Control patch in tutorial 8
- Fixes
This release contains:
-
Tutorials with complete standard DYCI2 functionalities. These self-contained Max applications and can be used as such by users who are not interested in building new patches.
-
The Max DYCI2 library of musical agents interfacing with the generation engine developped in Python and now built as an application
-
The Python DYCI2 library is also included for expert users, "hackers", or when getting troubles using the app version.
Getting started
See the 'quick start' pdf guide, follow the instructions below, then explore the tutorials in "Max_library/Tutorials/" !
Installation
- Download the .dmg file corresponding to your OS (see below: one version for OS >= High Sierra and < Catalina, one version for OS >= Catalina).
- Drag the DYCI2lib directory wherever you want (but not in Max packages / libraries !) and add its path into Max's search path (in Max: Options/File preferences... then add the path WITH THE SUBFOLDERS). /!\ The path of this folder must not contain any whitespace. /!\
- Insert the media files downloaded at http://repmus.ircam.fr/nika/dyci2_library in "MaxLibrary/Tutorials/_ExamplesCorpus_". /!\ The sampling rate of Max MUST be the same as that of the audio file(s) used in the memory(/ies). /!\
- On MacOS versions >= Catalina, the very first time you open the library, you will have to authorize the execution of the two DYCI2 externals (mubu, and shell) from the "Security & Privacy" menu in "System preference" of your computer. All this is explained in the pdf "DYCI2 start guide". Once this is done, you will never have to do it again.
(Open the "System preference / Security & Privacy" menu of your computer. Launch one of the Tutorial patchers. On the popup messages click on "Open" if possible, "Cancel" if not. In "System preference / Security & Privacy" click on "Open anyway" as soon as this option appears. When there are no more error messages quit Max. Launch one of the Tutorial patchers again, and repeat the operation until there are no more popup messages when opening a tutorial. You may have to quit and restart Max several times, but once this is done, you will never have to do it again.)
Requirements
- Mac OS >= High Sierra
- Max 8
- Mubu for Max: Open Max, File / Show Package Manager, Search "Mubu for Max", Install.
- Catart by Mubu: already included in DYCI2lib/Max_Library/external (but check the repository https://forum.ircam.fr/projects/detail/catart-mubu/ !)
- Max shell object: already included in DYCI2lib/Max_Library/external (but check the repository https://github.com/jeremybernstein/shell/releases !)
It you encounter some troubles after these steps, try to run DYCI2 from the Python code as detailed below.
Bonus: running DYCI2lib from the Python code instead of the app
(For expert users, "hackers", or when getting troubles using the app version).
This release also contains the Python DYCI2 library, defining models and tools for creative generation of sequences (and in particular musical sequences) from models of sequences. It implements several models, generative heuristics, time management strategies, and architectures of interactive agents.
Advanced users and developpers can use the Python library autonomously. See the tutorials corresponding to the different modulesHtml doc: http://repmus.ircam.fr/downloads/docs/DYCI2_library/. PDF doc: in DYCI2lib/Python_library.
NB: When launching the DYCI2 core using the python library and not the compiled app, the default command is "python3". Expert users can modify this command in the script located here: Dyci2Lib/Max_library/app/launch_dyci2_agents.sh
Configuration
- Download and install the last version of Python 3 (https://www.python.org/downloads).
- Open Terminal to install the dependencies:
cd [DRAG_AND_DROP_THE_DIRECTORY_Dyci2lib]
, enter,pip3 install -r requirements.txt --user
, enter.
Troubleshooting
Please write to jerome.nika@ircam.fr
for any question, or to share with us your projects using DYCI2 !
License
GPL v3
DYCI2lib 0.91 --> Built application
DYCI2_library
The DYCI2 library contains a collection of generative agents and tools for human-machine live interaction. It integrates the results of the DYCI2 project and shapes a next-generation software with regard to OMax.
If using the library, please quote: Nika, J., Déguernel, K., Chemla, A., Vincent, E., & Assayag, G. (2017, October). Dyci2 agents: merging the" free"," reactive", and" scenario-based" music generation paradigms. In International Computer Music Conference. (Article).
Some videos of artistic productions using DYCI2 or its previous versions: https://www.youtube.com/channel/UCAKZIW0mMWCrX80yS96ZxAw.
A recent presentation about the DYCI2 library (20 min in english): https://youtu.be/RXKJbpJb8w4?t=1530
Author: Jérôme Nika (IRCAM STMS LAB) ; Contributors: Joakim Borg (IRCAM STMS LAB), Ken Déguernel (IRCAM STMS LAB / Inria Nancy - Grand Est), Axel Chemla--Romeu-Santos (IRCAM STMS LAB), Georges Bloch (UniStra), Diemo Schwarz (IRCAM STMS LAB); DYCI2 research project : Gérard Assayag (Ircam, PI), Emmanuel Vincent (Inria Nancy, WP leader), Jérôme Nika (Ircam, WP coordinator), Marc Chemillier (EHESS, associate researcher).
This folder contains a release version of DYCI2lib ready to be used as a Max library (the corresponding development repository and the Python code are available here: https://github.com/DYCI2/Dyci2Lib).
Check also om-dyci2, the "offline" compositional declination of this project, a framework for interactive generation of musical sequences combining generative agents and computer-assisted composition tools.
Release
NEW:
- Application built from the Python code --> No need to use Python anymore (see below: one version for OS >= High Sierra and < Catalina, one version for OS >= Catalina)
- New tutos
- Control patch in tutorial 8
- Fixes
This release contains:
-
Tutorials with complete standard DYCI2 functionalities. These self-contained Max applications and can be used as such by users who are not interested in building new patches.
-
The Max DYCI2 library of musical agents interfacing with the generation engine developped in Python and now built as an application
-
The Python DYCI2 library is also included for expert users, "hackers", or when getting troubles using the app version.
Getting started
See the 'quick start' pdf guide, follow the instructions below, then explore the tutorials in "Max_library/Tutorials/" !
Installation
- Download the .dmg file corresponding to your OS (see below: one version for OS >= High Sierra and < Catalina, one version for OS >= Catalina).
- Drag the DYCI2lib directory wherever you want (but not in Max packages / libraries !) and add its path into Max's search path (in Max: Options/File preferences... then add the path WITH THE SUBFOLDERS). /!\ The path of this folder must not contain any whitespace. /!\
- Insert the media files downloaded at http://repmus.ircam.fr/nika/dyci2_library in "MaxLibrary/Tutorials/_ExamplesCorpus_". /!\ The sampling rate of Max MUST be the same as that of the audio file(s) used in the memory(/ies). /!\
- On MacOS versions >= Catalina, the very first time you open the library, you will have to authorize the execution of the two DYCI2 externals (mubu, and shell) from the "Security & Privacy" menu in "System preference" of your computer. All this is explained in the pdf "DYCI2 start guide". Once this is done, you will never have to do it again.
(Open the "System preference / Security & Privacy" menu of your computer. Launch one of the Tutorial patchers. On the popup messages click on "Open" if possible, "Cancel" if not. In "System preference / Security & Privacy" click on "Open anyway" as soon as this option appears. When there are no more error messages quit Max. Launch one of the Tutorial patchers again, and repeat the operation until there are no more popup messages when opening a tutorial. You may have to quit and restart Max several times, but once this is done, you will never have to do it again.)
Requirements
- Mac OS >= High Sierra
- Max 8
- Mubu for Max: Open Max, File / Show Package Manager, Search "Mubu for Max", Install.
- Catart by Mubu: already included in DYCI2lib/Max_Library/external (but check the repository https://forum.ircam.fr/projects/detail/catart-mubu/ !)
- Max shell object: already included in DYCI2lib/Max_Library/external (but check the repository https://github.com/jeremybernstein/shell/releases !)
It you encounter some troubles after these steps, try to run DYCI2 from the Python code as detailed below.
Bonus: running DYCI2lib from the Python code instead of the app
(For expert users, "hackers", or when getting troubles using the app version).
This release also contains the Python DYCI2 library, defining models and tools for creative generation of sequences (and in particular musical sequences) from models of sequences. It implements several models, generative heuristics, time management strategies, and architectures of interactive agents.
Advanced users and developpers can use the Python library autonomously. See the tutorials corresponding to the different modulesHtml doc: http://repmus.ircam.fr/downloads/docs/DYCI2_library/. PDF doc: in DYCI2lib/Python_library.
NB: When launching the DYCI2 core using the python library and not the compiled app, the default command is "python3". Expert users can modify this command in the script located here: Dyci2Lib/Max_library/app/launch_dyci2_agents.sh
Configuration
- Download and install the last version of Python 3 (https://www.python.org/downloads).
- Open Terminal to install the dependencies:
cd [DRAG_AND_DROP_THE_DIRECTORY_Dyci2lib]
, enter,pip3 install -r requirements.txt --user
, enter.
Troubleshooting
Please write to jerome.nika@ircam.fr
for any question, or to share with us your projects using DYCI2 !
License
GPL v3
DYCI2Lib 0.9 --> Python 3
DYCI2_library
The DYCI2 library contains a collection of generative agents and tools for smart composition and human-machine co-improvisation.
It integrates the results of the DYCI2 project and shapes a next-generation software with regard to OMax.
A conference paper about the DYCI2 library can be downloaded here.
A recent presentation about the DYCI2 library (20 min in english): https://youtu.be/RXKJbpJb8w4?t=1530
Some videos of collaborations with musicians using DYCI2 or its previous versions: https://www.youtube.com/channel/UCAKZIW0mMWCrX80yS96ZxAw.
Author: Jérôme Nika (IRCAM STMS LAB) ; Contributors: Joakim Borg (IRCAM STMS LAB), Ken Déguernel (IRCAM STMS LAB / Inria Nancy - Grand Est), Axel Chemla--Romeu-Santos (IRCAM STMS LAB), Georges Bloch (UniStra), Diemo Schwarz (IRCAM STMS LAB); DYCI2 research project : Gérard Assayag (Ircam, PI), Emmanuel Vincent (Inria Nancy, WP leader), Jérôme Nika (Ircam, WP coordinator), Marc Chemillier (EHESS, associate researcher).
Release
NEW:
- Python 3
- New interface
- New tutos
This release contains:
-
Tutorials with complete standard DYCI2 functionalities. These self-contained Max applications and can be used as such by users who are not interested in building new patches.
-
The Max DYCI2 library of musical agents interfacing with the generation engine developped in Python.
-
The Python DYCI2 library, defining models and tools for creative generation of sequences (and in particular musical sequences) from models of sequences. It implements several models, generative heuristics, time management strategies, and architectures of interactive agents.
Advanced users and developpers can use the Python library autonomously. See the tutorials corresponding to the different modulesHtml doc: http://repmus.ircam.fr/downloads/docs/DYCI2_library/. PDF doc: in DYCI2lib/Python_library.
NB: When launching the DYCI2 core using the python library and not the compiled app, the default command is "python3". Expert users can modify this command in the script located here: Dyci2Lib/Max_library/app/launch_dyci2_agents.sh
Requirements
- Mac OS
- Max 8
- Python 3.9 and >
- Mubu for Max: Open Max, File / Show Package Manager, Search "Mubu for Max", Install.
- Catart by Mubu: already included in DYCI2lib/Max_Library/external (but check the repository https://forum.ircam.fr/projects/detail/catart-mubu/ !)
- Max shell object: already included in DYCI2lib/Max_Library/external (but check the repository https://github.com/jeremybernstein/shell/releases !)
Installation
- Drag the DYCI2lib directory wherever you want (but not in Max packages / libraries !) and add its path into Max's search path (in Max: Options/File preferences... then add the path WITH THE SUBFOLDERS). /!\ The path of this folder must not contain any whitespace. /!\
- Insert the media files downloaded at http://repmus.ircam.fr/nika/dyci2_library in "MaxPatches/Tutorials/_ExamplesCorpus_". /!\ The sampling rate of Max MUST be the same as that of the audio file(s) used in the memory(/ies). /!\
Python configuration
- Download and install the last version of Python 3 (https://www.python.org/downloads).
- Open Terminal to install the dependencies:
cd [DRAG_AND_DROP_THE_DIRECTORY_Dyci2lib]
, enter,pip3 install -r requirements.txt --user
, enter.
Troubleshooting
Please write to jerome.nika@ircam.fr
for any question, or to share with us your projects using DYCI2 !
License
GPL v3
DYCI2Lib 0.7 --> new interface + self contained applications + new playing modes + new tutos
__A little patience until March 20th 2020 and the next release will be very different from this one! (Core in python3, no need to install python anymore, new tutorials, etc. __
Tutorials
Download the Dyci2Lib-v07.zip archive below and read the following instructions:
Release
This release contains:
-
Tutorials that are actual self-contained applications and can be used as such by users who are not interested in building new patches.
-
The Max DYCI2 library of musical agents interfacing with the Python library. (See the tutorials in the directory Max_library/_Tutorials_ and the Readme file to download sound examples).
-
The Python DYCI2 library, defining models and tools for creative generation of sequences (and in particular musical sequences) from models of sequences. It implements several models, generative heuristics, time management strategies, and architectures of interactive agents. Each class is associated with a tutorial (see the tutorials in the Python_library directory).
NEW:
- New interface
- New playing modes and categories : Listen, Match, Develop, Accompany, Augment, Guide
- New self contained applications
- New tutos
COMING SOON - DYCI2Lib 1.0 !:
- Python 3
- Application (no need to install Python etc.)
- Standalone
Installation
-
Download and install the last version of Python 2 (https://www.python.org/downloads). Python 2.7 <= required version < Python 3 (DYCI2 for Python 3 coming soon...)
-
Open Terminal to install the dependencies:
cd [DRAG_AND_DROP_THE_DIRECTORY_Dyci2lib]
pip install -r requirements.txt
(If pip is not installed: sudo easy-install pip
, or try curl https://bootstrap.pypa.io/get-pip.py | python
)
-
Download Mubu for Max, in Max:
- File / Show Package Manager
- Search "Mubu for Max"
- Install
-
Finally move the whole directory wherever you want, and make sure that the path of the directory Dyci2lib/Max_library is set in the file preferences in Max. Then explore the tutorials !
DYCI2 tutorials
The DYCI2 library offers different processes depending on the way the "musical memory" of your agent is created, and a range of generative strategies adapted to different types of interaction. The tutorials in Dyci2lib/Max_library_/Tutorials_ give an overview that should be sufficient to be able to build new setups.
Start with DYCI2_Tutorials_Read_me_first.maxpat to go through the tutorials.
Download the sound database for the tutorials. See Below: Download-Instructions-DYCI2-Tutoriel-Soundfiles.txt]. _
(Other sources: https://github.com/DYCI2/Dyci2Lib/releases or http://repmus.ircam.fr/nika/dyci2_library)
Before using the tutorials, make sure you followed the installation procedure above, and insert the files downloaded at the previous step in "DYCI2Lib/MaxPatches/Tutorials/_ExamplesCorpus_".
(!! If you already have a python distribution installed and that the shell command "python" calls Python 3, please replace the "DYCI2_Python_lib" objects in the patches by "DYCI2_Python2_lib" objects. !!)
Download-Instructions-DYCI2-Tutoriel-Soundfiles.txt
Videos of productions and artistic collaborations using DYCI2lib: https://www.youtube.com/playlist?list=PL-C_JLZNFAGfGwtMPrRz9gOD3LnAMnHkO
Associated IRCAM / Repmus project: http://repmus.ircam.fr/dyci2/home
Associated research: https://jeromenika.com/research-designing-generative-agents/dyci2lib/
DYCI2Lib 0.6 --> multi-agent reactive listening + new tutos
Download the Dyci2Lib-v06.zip archive below and read the following instructions:
Release
This release contains:
-
The Max DYCI2 library of musical agents interfacing with the Python library. (See the tutorials in the directory Max_library/_Tutorials_ and the Readme file to download sound examples).
-
The Python DYCI2 library, defining models and tools for creative generation of sequences (and in particular musical sequences) from models of sequences. It implements several models, generative heuristics, time management strategies, and architectures of interactive agents. Each class is associated with a tutorial (see the tutorials in the Python_library directory).
NEW:
- New implementation of the generative agents based on reactive listening.
- Possibility to have several "reactive listening" agents.
- New presets patches for memory & type of listening and reaction to the live inputs.
- New tutorials.
See in particular Tuto-AM3--3agents_reactive_listening. - New guide DYCI2_Tutorials_Read_me_first.maxpat to go through the tutorials.
- Fixes
Installation
-
Download and install the last version of Python 2 (https://www.python.org/downloads). Python 2.7 <= required version < Python 3 (DYCI2 for Python 3 coming soon...)
-
Open Terminal to install the dependencies:
cd [DRAG_AND_DROP_THE_DIRECTORY_Dyci2lib]
pip install -r requirements.txt
(If pip is not installed: sudo easy-install pip
, or try curl https://bootstrap.pypa.io/get-pip.py | python
)
-
Download Mubu for Max, in Max:
- File / Show Package Manager
- Search "Mubu for Max"
- Install
-
Finally move the whole directory wherever you want, and make sure that the path of the directory Dyci2lib/Max_library is set in the file preferences in Max. Then explore the tutorials !
DYCI2 tutorials
The DYCI2 library offers different processes depending on the way the "musical memory" of your agent is created, and a range of generative strategies adapted to different types of interaction. The tutorials in Dyci2lib/Max_library_/Tutorials_ give an overview that should be sufficient to be able to build new setups.
Start with DYCI2_Tutorials_Read_me_first.maxpat to go through the tutorials.
Before using the tutorials, make sure you followed the installation procedure above, and insert the files downloaded at http://repmus.ircam.fr/nika/dyci2_library in "MaxPatches/Tutorials/_ExamplesCorpus_".
DYCI2Lib 0.5 --> reactive listening ++
Download the Dyci2Lib-v05.zip archive below and read the following instructions:
Release
This release contains:
-
The Max DYCI2 library of musical agents interfacing with the Python library. (See the tutorials in the directory Max_library/_Tutorials_ and the Readme file to download sound examples).
-
The Python DYCI2 library, defining models and tools for creative generation of sequences (and in particular musical sequences) from models of sequences. It implements several models, generative heuristics, time management strategies, and architectures of interactive agents. Each class is associated with a tutorial (see the tutorials in the Python_library directory).
NEW:
- New implementation of the generative agents based on reactive listening.
See in particular Tuto-AM2--1agent_reactive_listening_1.maxpat. - New tutorials.
- New guide DYCI2_Tutorials_Read_me_first.maxpat to go through the tutorials.
- More ergonomics.
Installation
-
Download and install the last version of Python 2 (https://www.python.org/downloads).
-
Open Terminal to install the dependencies:
cd [DRAG_AND_DROP_THE_DIRECTORY_Dyci2lib]
pip install -r requirements.txt
(If pip is not installed: sudo easy-install pip
, or try curl https://bootstrap.pypa.io/get-pip.py | python
)
-
Download Mubu for Max, in Max:
- File / Show Package Manager
- Search "Mubu for Max"
- Install
-
Finally move the whole directory wherever you want, and make sure that the path of the directory Dyci2lib/Max_library is set in the file preferences in Max. Then explore the tutorials !
DYCI2 tutorials
The DYCI2 library offers different processes depending on the way the "musical memory" of your agent is created, and a range of generative strategies adapted to different types of interaction. The tutorials in Dyci2lib/Max_library_/Tutorials_ give an overview that should be sufficient to be able to build new setups.
Start with DYCI2_Tutorials_Read_me_first.maxpat to go through the tutorials.
Before using the tutorials, make sure you followed the installation procedure above, and insert the files downloaded at http://repmus.ircam.fr/nika/dyci2_library in "MaxPatches/Tutorials/_ExamplesCorpus_".
DYCI2 library
Release
This release contains:
-
The Python DYCI2 library, defining models and tools for creative generation of sequences (and in particular musical sequences) from models of sequences. It implements several models, generative heuristics, time management strategies, and architectures of interactive agents. Each class is associated with a tutorial (see the tutorials in the Python_library directory).
-
The Max DYCI2 library of musical agents interfacing with the Python library. (See the tutorials in the directory Max_library/_Tutorials_ and the Readme file to download sound examples).
Configuration and installation
-
Download and install the last version of Python 2 (https://www.python.org/downloads).
-
Use your terminal in the directory Dyci2Lib to install the dependencies:
$ pip install -r requirements.txt
(If pip is not installed: sudo easy-install pip
, or try curl https://bootstrap.pypa.io/get-pip.py | python
)
-
Make sure that the path of the directory Max_library is set in the file preferences in Max.
-
The reactive listening modules (Tutorials "B...") require the Mubu for Max package. In Max 7:
- File / Show Package Manager
- Search "Mubu for Max"
- Install
Using the tutorials
To use the Max tutorials in "MaxPatches/_Tutorials_", insert the tutorial audio files downloaded at http://repmus.ircam.fr/nika/dyci2_library in "MaxPatches/_Tutorials_/_ExamplesCorpus_".
To use you own annotated musical memories use the Max tutorial "A5" or
- Create a .csv / .txt annotation file with the following format
start_date_event_1_in_ms ; label_1_1 ... label_1_j
...
start_date_event_i_in_ms ; label_i_1 ... label_i_j
date_end_file_in_ms ; X
See the example of Female-Voice-singing.csv --> Female-Voice-singing.json (annotation for Female-Voice-singing.aiff)
-
Use the script FromTextToDYCI2json_script (/!\ No "." or " "in the whole path of the file (except extension) /!), for example :
$ python FromTextToDYCI2json_script.py [absolute path to the .csv/.txt file]
-
Move the .json file and your .aif sound file in /MaxPatches/Tutorials/ExamplesCorpus