Metadata-Version: 2.4
Name: bbmuse
Version: 0.2.0
Summary: BlackBoard MUSic Engine - A blackboard system for realtime AI music generation
Author-email: Fabian Ostermann <fabian.ostermann@tu-dortmund.de>
License-Expression: MIT
Project-URL: Homepage, https://github.com/fabianostermann/bbmuse
Project-URL: Issues, https://github.com/fabianostermann/bbmuse/issues
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: plot
Requires-Dist: networkx; extra == "plot"
Requires-Dist: matplotlib; extra == "plot"
Provides-Extra: learn
Requires-Dist: torch; extra == "learn"
Requires-Dist: numpy; extra == "learn"
Requires-Dist: tqdm; extra == "learn"
Requires-Dist: pandas; extra == "learn"
Provides-Extra: editor
Requires-Dist: nicegui; extra == "editor"
Provides-Extra: all
Requires-Dist: bbmuse[editor,learn,plot]; extra == "all"
Dynamic: license-file

# BlackBoard MUSic Engine

BbMuse is an open-source platform-independent Python framework and backend for interactive AI systems based on the good old concept of blackboard systems.
It aims to fill the gap between ad hoc multi-agent systems that require complex manual "wiring" and monolithic neural models that act as opaque "black boxes".
By adapting a modern blackboard architecture from real-time robotics, we create a system where real-time musical composition is treated as a distributed hierarchical decision-making process.

## Links

- [<img src="https://upload.wikimedia.org/wikipedia/commons/0/04/PyPI-Logo-notext.svg" alt="" height="24"/> PyPI release](https://pypi.org/project/bbmuse)

- [<img src="https://upload.wikimedia.org/wikipedia/commons/2/2f/Github_Topicon.svg" alt="" height="24"/> GitHub repo](https://github.com/fabianostermann/bbmuse)

- [Collection of templates and examples](https://github.com/fabianostermann/bbmuse-templates)

- [<img src="https://icmc2026.ligeti-zentrum.de/wp-content/uploads/2026/04/icmc2026_logo_w-scaled.png" alt="ICMC 2026" height="24"/> conference paper](https://icmc2026.ligeti-zentrum.de/proceedings) introducing BbMuse and its main concepts.
 
- [<img src="https://aimusiccreativity.org/2025/images/logo_white_short.svg" alt="AIMC 2026" height="24"/> conference paper](https://aimc2026.org/home) presenting BbLearn: an AI extension for BbMuse living in the same repo.

## Installation and first-run experience

To comfortably install via PyPI, use: `pip install bbmuse`

To install locally (e.g., if cloned from GitHub), use: `pip install -e .` (from inside the cloned directory)

To quickly test your installation, run: `bbmuse tests/DummyProject/ --quit-after 5`

For additional usage, run: `bbmuse --help`

