Compose Music with Code: Exploring the Python musicpy Library

Ever wondered how to write music with code? musicpy is a Chinese‑authored Python library that enables you to express notes, rhythms, and other musical information using a compact, music‑theory‑based syntax and export the result as a MIDI file.

The library assumes some familiarity with music theory; beginners should learn basic concepts first, while experienced musicians can quickly follow the author’s Wiki tutorial.

Installation

Run pip install -r requirements.txt in the musicpy folder (or simply pip install musicpy if already installed). Then import the library with from musicpy import *.

Core classes include note (representing a single pitch), chord (a collection of notes), and scale (a series of notes). Notes are represented as pure numbers, allowing direct arithmetic operations. Chords behave as numeric vectors or matrices, enabling linear‑algebraic manipulations.

Because these structures are numeric, they can participate in mathematical operations from linear algebra to discrete mathematics, facilitating algorithmic analysis and composition based on formal music‑theory logic.

The library supports creating experimental music such as serialism, aleatoric, or minimalist styles, as well as classical, jazz, and pop genres, all through its numeric data model.

Updates are logged in Changelog.txt within the repository, with frequent releases documenting detailed changes.

Motivation

The author aims to represent music composition from a theoretical perspective, reducing verbose MIDI data to concise code, and to provide an interface for AI composers that understand music theory rather than relying on deep‑learning models.

By teaching AI explicit music‑theory rules via musicpy, AI can compose with genuine understanding, avoid random or mechanical output, and even emulate specific composers’ styles through quantifiable rule sets.

The library is available on PyPI; install it with pip install musicpy. The project’s GitHub repository and Wiki contain further documentation, tutorials, and a changelog.