Music21 welcomes contributions such as bug reports, new features, fixes, and
documentation improvements. The
project repository is hosted at GitHub.
Information that was formerly here is now in Developer Reference
Pull requests or issues created primarily with AI or in other ways not directly authored by the contributor must be declared with (AI) or (AI Generated) in their issue/PR titles. If not accepted, they will generally be closed without comment unless the contributor has a demonstrated track record of being able to fix the code in question. Reviewers that do not disclose AI usage will be politely reminded the first time and may be blocked for subsequent lack of disclosure. (New in 2025: this is a pre-emptive time savings from experiences on other Open Source projects.)
In 2026 we welcome AI-Assisted contributions, but users must take responsibility for them and they must match the code-style of the rest of the music21 project. "Slop that works somehow" will not be accepted.
When opening an issue or pull request in Github, templates will appear to guide you in making
the request. If you are opening in a different way, like through an agent tool, those
templates may not appear -- be sure your agent is reading them in .github/ anyhow, since
they are required to be used. Thanks!
If this is your first PR, an automated check of your account credentials will be run and if there are any issues this will be posted publicly as a comment on the PR.