⭐️ Tölvera has been selected for Mozilla's first Builders Accelerator! Read the announcement and join our Discord!

Tölvera is a Python library designed for composing together and interacting with basal agencies, inspired by fields such as artificial life (ALife) and self-organising systems. It provides creative coding-style APIs that allow users to combine and compose various built-in behaviours, such as flocking, slime mold growth, and swarming, and also author their own.

With built-in support for Open Sound Control (OSC) via iipyper and interactive machine learning (IML) via anguilla, Tölvera interfaces with and rapidly maps onto existing creative computing software and hardware, striving to be both an accessible and powerful tool for exploring diverse intelligence in artistic contexts.

Inspired by our lab's location in Iceland, the word Tölvera is an Icelandic kenning based on tölva meaning computer, from tala (number) and völva (prophetess), and vera (being), composed together as number being.

We have employed Tölvera in various collaborative artistic works, including musical performances, compositions, and multimedia installations (see references.bib for peer-reviewed publications). Tölvera's role in these pieces has mainly been "mappable behaviour engine", where interface inputs can control Tölvera programs, and Tölvera runtime data can control interface outputs, in practically any combination. In this way, and to controllable degrees, Tölvera can contribute to the underlying dynamics of a given interactive scenario. It can also add a visual component, and equally has been used without projection in other works.

Tölvera makes use of Taichi, a domain-specific language embedded in Python that enables parallelisation, and is experimental software subject to change.

We would be happy to have you join us on our Discord server!

Examples can be found at iil-examples/tolvera. See also the guide, reference and experiments pages.

Visit the YouTube Playlist (if you'd like to add a video, please get in touch).

Taichi supports numerous operating systems and backends. If you plan on using Vulkan for graphics (recommended for macOS), you may need to install the Vulkan SDK first and restart your machine.

Tölvera is registered on PyPI and can be installed via a Python package manager such as pip:

pip install tolvera

For development, we use poetry. Fork/clone this repository and install the package with `poetry:

git clone https://github.com/Intelligent-Instruments-Lab/tolvera # (or clone your own fork)
cd tolvera
poetry install

• Tölvera currently does not support Python 3.12 and above - a Python 3.11 installation is recommended. This can be created in the following way using miniconda:

conda create -n tolvera python=3.11
conda activate tolvera

• Tölvera does not support Intel-based Apple devices (due to anguilla's FAISS dependency, and Mediapipe not supporting Intel Macs).
• On macOS, an OpenMP issue may prevent Tölvera programs from running, which can be addressed by adding the following environment variable:

export KMP_DUPLICATE_LIB_OK=TRUE

• Sonification via SignalFlow does not work on Windows.
• Mediapipe versions may need to be downgraded in order to work on macOS and Windows.
• OSError: Could not find any hidapi library: this is due to the DualSense (PS5 controller) class. On macOS you can brew install hidapi and it should work.

We welcome Pull Requests across all areas of the project:

• Addressing Issues
• Adding features (see Issues and Discussion)
• Examples
• Tests
• Documentation

To discuss Tölvera with developers and other users:

• Use GitHub Issues to report bugs and make specific feature requests.
• Use GitHub Discussions to share ideas and ask questions.
• Use Discord for further support, sharing your work, and general chat.

Across the project, we follow the Berlin Code of Conduct. Please get in touch if you experience or witness any conduct issues.

See Discussion.

Tölvera is being written about and used in a number of contexts (see references.bib). The current canonical citation is our NIME 2024 paper:

@inproceedings{armitageTolveraComposingBasal2024,
  title = {T{\"o}lvera: {{Composing With Basal Agencies}}},
  booktitle = {Proc. {{New Interfaces}} for {{Musical Expression}}},
  author = {Armitage, Jack and Shepardson, Victor and Magnusson, Thor},
  year = {2024},
  address = {Utrecht, NL},
}

• Michael Levin
• SwissGL
• Lenia
• Particle Life (attributed to various, see for example Clusters)
• Journey to the Microcosmos
• Complexity Explorables

Tölvera is developed by Jack Armitage.

We thank the Taichi community for their project that makes Tölvera possible.

Tölvera was originally created at the Intelligent Instruments Lab.