Text-to-Music Prompt Structurer

Turn free-form musical ideas into structured prompts for text-to-music workflows.

The package detects genre, mood, BPM, key, instruments, production details, language, voice type, vocal tone, and vocal technique. It has no runtime dependencies and requires Python 3.10 or later.

Install

python -m pip install text-to-music-prompt-structurer

Command line

text-to-music-prompt "neo soul with piano, warm breathy female alto vocals in Spanish, intimate and melismatic, in d minor, nostalgic, 92 bpm"

Output:

STYLE: Soul / Neo Soul
MOOD: Nostalgic, Warm
BPM: ~92
KEY: D Minor
INSTRUMENTS: Piano
PRODUCTION: Warm tone
VOCALS:
  LANGUAGE: Spanish
  VOICE TYPE: Female Lead, Alto
  TONE: Warm, Breathy, Intimate
  STYLE: Melismatic vocals

Python

from text_to_music_prompt_structurer import MusicPromptEngine, format_prompt

prompt = MusicPromptEngine().process(
    "synthwave with 808, dark and dreamy, female vocals in English"
)

print(format_prompt(prompt))

Output:

STYLE: Synthwave
MOOD: Dark, Dreamy
INSTRUMENTS: 808 Bass
PRODUCTION: Dark tone
VOCALS:
  LANGUAGE: English
  VOICE TYPE: Female Lead
  TONE: Dark

process() returns a MusicPrompt object, so applications can use each detected value directly instead of parsing the formatted text. Its fields cover:

• Musical direction: genre, subgenre, mood, energy, tempo, bpm, and key.
• Arrangement and sound: instruments, production, rhythm, structure, and era.
• Vocal direction: language, voice_type, vocal_tone, and vocal_style.

format_prompt() renders only the detected fields as a ready-to-use structured prompt.

Development

git clone https://github.com/edujbarrios/text-to-music-prompt-structurer.git
cd text-to-music-prompt-structurer
python -m pip install -e ".[dev]"
python -m pytest
ruff check .

See CONTRIBUTING.md to add vocabularies or detection strategies. Release history is available in CHANGELOG.md.

License

Copyright © 2026 Eduardo J. Barrios.

This project is licensed under the Mozilla Public License 2.0. MPL 2.0 is a file-level copyleft license: modifications to covered source files must remain available under MPL 2.0, while those files may be combined with code under other licenses. See NOTICE for attribution details.