Initial commit: Suno Prompt Generator app

Gradio web app that converts natural language song ideas into structured
Suno AI prompts via OpenRouter API. Features model selection, weirdness
slider for creative control, and outputs for style prompt, song title,
lyrics with tags, Suno UI settings, and cover art image prompt.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

.env.example

@@ -0,0 +1,3 @@
+# OpenRouter API Key
+# Get yours at https://openrouter.ai/keys
+OPENROUTER_API_KEY=sk-or-v1-your-key-here

.gitignore

@@ -0,0 +1,4 @@
+venv/
+__pycache__/
+*.pyc
+.env

Launch Suno Prompter.bat

@@ -0,0 +1,4 @@
+@echo off
+cd /d "%~dp0"
+venv\Scripts\python.exe app.py
+pause

app.py

@@ -0,0 +1,244 @@
+"""
+Suno Prompting App
+Converts natural language song ideas into structured Suno AI prompts via OpenRouter API.
+"""
+
+import json
+import os
+
+import gradio as gr
+from dotenv import load_dotenv
+from openai import OpenAI
+
+from knowledge_base import build_system_prompt
+
+# ─────────────────────────────────────────────
+# CONFIG
+# ─────────────────────────────────────────────
+
+load_dotenv()
+
+OPENROUTER_API_KEY = os.getenv("OPENROUTER_API_KEY", "")
+
+MODELS = {
+    "Google Gemini 3 Pro": "google/gemini-3-pro-preview",
+    "Google Gemini 3 Flash": "google/gemini-3-flash-preview",
+    "Anthropic Claude Sonnet 4.6": "anthropic/claude-sonnet-4.6",
+    "OpenAI GPT-5.2": "openai/gpt-5.2",
+    "xAI Grok 4": "x-ai/grok-4",
+    "Custom": "custom",
+}
+
+client = OpenAI(
+    base_url="https://openrouter.ai/api/v1",
+    api_key=OPENROUTER_API_KEY,
+)
+
+
+# ─────────────────────────────────────────────
+# CORE LOGIC
+# ─────────────────────────────────────────────
+
+def generate_prompt(song_idea: str, model_choice: str, custom_model: str, weirdness: int):
+    """Call OpenRouter and parse the structured response."""
+    if not song_idea.strip():
+        return "", "Please enter a song idea.", "", "", ""
+
+    # Resolve model ID
+    if model_choice == "Custom":
+        model_id = custom_model.strip()
+        if not model_id:
+            return "", "Please enter a custom model ID.", "", "", ""
+    else:
+        model_id = MODELS.get(model_choice, "google/gemini-3-flash-preview")
+
+    system_prompt = build_system_prompt(weirdness)
+
+    try:
+        response = client.chat.completions.create(
+            model=model_id,
+            messages=[
+                {"role": "system", "content": system_prompt},
+                {"role": "user", "content": song_idea},
+            ],
+            temperature=0.9,
+            max_tokens=4096,
+        )
+
+        raw = response.choices[0].message.content.strip()
+
+        # Strip markdown code fences if present
+        if raw.startswith("```"):
+            lines = raw.split("\n")
+            # Remove first line (```json or ```) and last line (```)
+            if lines[-1].strip() == "```":
+                lines = lines[1:-1]
+            else:
+                lines = lines[1:]
+            raw = "\n".join(lines)
+
+        data = json.loads(raw)
+
+        song_title = data.get("song_title", "Untitled")
+        style_prompt = data.get("style_prompt", "")
+        lyrics = data.get("lyrics", "")
+
+        # Build settings display
+        w = data.get("weirdness", "N/A")
+        w_reason = data.get("weirdness_reasoning", "")
+        si = data.get("style_influence", "N/A")
+        si_reason = data.get("style_influence_reasoning", "")
+        settings = f"Weirdness: {w}/100\n{w_reason}\n\nStyle Influence: {si}/100\n{si_reason}"
+
+        cover_art = data.get("cover_art_prompt", "")
+
+        return song_title, style_prompt, lyrics, settings, cover_art
+
+    except json.JSONDecodeError:
+        # If JSON parsing fails, show raw response
+        return (
+            "",
+            f"[JSON parse error - raw response below]\n\n{raw}",
+            "",
+            "",
+            "",
+        )
+    except Exception as e:
+        return "", f"Error: {e}", "", "", ""
+
+
+def toggle_custom_visibility(choice):
+    """Show/hide custom model text field."""
+    return gr.update(visible=(choice == "Custom"))
+
+
+# ─────────────────────────────────────────────
+# UI
+# ─────────────────────────────────────────────
+
+theme = gr.themes.Base(
+    primary_hue=gr.themes.colors.orange,
+    secondary_hue=gr.themes.colors.neutral,
+    neutral_hue=gr.themes.colors.gray,
+    font=gr.themes.GoogleFont("Inter"),
+).set(
+    body_background_fill="#1a1a1a",
+    body_background_fill_dark="#1a1a1a",
+    body_text_color="#e0e0e0",
+    body_text_color_dark="#e0e0e0",
+    block_background_fill="#2a2a2a",
+    block_background_fill_dark="#2a2a2a",
+    block_border_color="#444",
+    block_border_color_dark="#444",
+    block_label_text_color="#ccc",
+    block_label_text_color_dark="#ccc",
+    block_title_text_color="#fff",
+    block_title_text_color_dark="#fff",
+    input_background_fill="#333",
+    input_background_fill_dark="#333",
+    input_border_color="#555",
+    input_border_color_dark="#555",
+    button_primary_background_fill="#e67e22",
+    button_primary_background_fill_dark="#e67e22",
+    button_primary_background_fill_hover="#d35400",
+    button_primary_background_fill_hover_dark="#d35400",
+    button_primary_text_color="#fff",
+    button_primary_text_color_dark="#fff",
+)
+
+with gr.Blocks(title="Suno Prompt Generator") as app:
+    gr.Markdown("# Suno Prompt Generator\nDescribe your song idea in natural language. Get back structured Suno prompts.")
+
+    with gr.Row():
+        model_dropdown = gr.Dropdown(
+            choices=list(MODELS.keys()),
+            value="Google Gemini 3 Flash",
+            label="AI Model",
+            scale=2,
+        )
+        custom_model_input = gr.Textbox(
+            label="Custom Model ID",
+            placeholder="e.g. meta-llama/llama-4-maverick",
+            visible=False,
+            scale=2,
+        )
+
+    song_input = gr.Textbox(
+        label="Song Idea",
+        placeholder="A melancholy song about driving alone at night on empty highways, with a female vocal that sounds tired but hopeful...",
+        lines=4,
+    )
+
+    weirdness_slider = gr.Slider(
+        minimum=0,
+        maximum=100,
+        value=30,
+        step=1,
+        label="Weirdness (0 = conventional, 100 = maximum creative hallucination)",
+    )
+
+    generate_btn = gr.Button("Generate Suno Prompt", variant="primary", size="lg")
+
+    gr.Markdown("---")
+
+    style_output = gr.Textbox(
+        label="Style Prompt (paste into Suno's Style Prompt field)",
+        lines=5,
+        buttons=["copy"],
+        interactive=False,
+    )
+
+    title_output = gr.Textbox(
+        label="Song Title",
+        lines=1,
+        buttons=["copy"],
+        interactive=False,
+    )
+
+    lyrics_output = gr.Textbox(
+        label="Lyrics with Tags (paste into Suno's Lyrics field)",
+        lines=20,
+        buttons=["copy"],
+        interactive=False,
+    )
+
+    with gr.Row():
+        settings_output = gr.Textbox(
+            label="Suno UI Settings",
+            lines=5,
+            interactive=False,
+            scale=1,
+        )
+
+    gr.Markdown("---")
+
+    cover_art_output = gr.Textbox(
+        label="Cover Art Image Prompt (paste into Grok or image generator)",
+        lines=6,
+        buttons=["copy"],
+        interactive=False,
+    )
+
+    # Events
+    model_dropdown.change(
+        fn=toggle_custom_visibility,
+        inputs=model_dropdown,
+        outputs=custom_model_input,
+    )
+
+    outputs = [title_output, style_output, lyrics_output, settings_output, cover_art_output]
+
+    generate_btn.click(
+        fn=generate_prompt,
+        inputs=[song_input, model_dropdown, custom_model_input, weirdness_slider],
+        outputs=outputs,
+    )
+
+    song_input.submit(
+        fn=generate_prompt,
+        inputs=[song_input, model_dropdown, custom_model_input, weirdness_slider],
+        outputs=outputs,
+    )
+
+if __name__ == "__main__":
+    app.launch(inbrowser=True, theme=theme)

knowledge_base.py

@@ -0,0 +1,326 @@
+"""
+Consolidated Suno knowledge base.
+Builds system prompts with weirdness-scaled creative layers.
+Sources: Suno Database.txt, Suno AI Prompt Mechanics Guide.pdf, Suno Prompt Generator (Gemini Instructions).pdf
+"""
+
+# ─────────────────────────────────────────────
+# BASE SYSTEM PROMPT (always sent)
+# ─────────────────────────────────────────────
+
+BASE_PROMPT = """\
+You are a Suno AI prompt engineer. You take natural-language song ideas and produce structured prompts optimized for Suno's music generation engine. You also create evocative song titles and rich cover art image prompts.
+
+=== HARD CONSTRAINTS ===
+
+Tag Weighting: Position 1 = ~50% influence, Position 2 = ~25%, Position 3 = ~12.5%, Position 4+ = diminishing. Always frontload the most important sonic element.
+
+Style Prompt: 200-400 chars optimal (sweet spot 250-350). Beyond 400 = dilution and ignored descriptors.
+
+Lyrics Field: Use structure tags on their own lines. Keep section-specific changes, performance cues, and actual lyrics here. Tempo and Key go in STYLE PROMPT ONLY, do NOT repeat in lyrics.
+
+BANNED (Suno ignores these): Frequency specs (40Hz, 2kHz), decibel specs (-6dB, -30dB), time-based specs (6-second decay), DAW terms (sidechain compression, transient shaping), stereo positioning (hard-panned L/R), mastering specs (-14 LUFS, -3 dBTP), bit depth (12-bit reduction).
+
+USE INSTEAD: Qualitative descriptors ("deep bass," "punchy kicks," "crisp hats"), texture words ("lo-fi," "tape saturation," "vinyl crackle," "analog," "warm," "bitcrushed"), instrument names ("808 drums," "Rhodes piano," "TR-808"), mood words, physical placement ("close-mic," "room reverb," "distant").
+
+=== WORKING PRODUCTION TERMS ===
+
+Drums: "TR-808 drums," "fast hi-hats," "punchy kicks," "sparse drums," "live drums"
+Bass: "808 sub bass," "sliding bass," "deep bass," "tight bass"
+Reverb: "plate reverb," "room reverb," "reverb-heavy," "hall reverb," "wet reverb," "long reverb tails," "ambient reverb," "tape reverb"
+Delay: "slapback delay," "ping-pong delay," "tape delay," "dotted delay"
+Texture: "lo-fi," "analog," "warm," "vintage," "tape saturation," "vinyl crackle," "bitcrushed"
+Synths: "analog synths," "atmospheric pads," "dark synths," "ethereal pads," "bright synths," "FM bells," "wavetable," "sub-bass synth," "grain synth," "pluck synth"
+Guitars: "distorted guitars," "clean guitar," "acoustic guitar," "jangly guitars," "fingerpicked guitar," "palm-muted guitar," "slide guitar," "guitar harmonics," "tremolo guitar"
+Keys: "Rhodes piano," "piano," "organ," "electric piano"
+Strings/Orchestral: "strings legato," "strings staccato," "strings pizzicato," "muted brass," "open brass," "breathy woodwinds"
+Percussion: "hand percussion," "shakers," "cajon," "808 kick," "electronic percussion"
+Compression: "transparent compression," "glue compression," "pumpy compression"
+Tonal Balance: "bright top," "warm low-mids," "clean midrange," "bass-forward," "airy highs"
+
+=== PERFORMANCE & HUMANIZATION ===
+
+Humanization (makes performances feel organic, not robotic):
+- Microtiming: subtle timing variations ("humanized timing," "loose feel," "tight performance")
+- Velocity variance: dynamic variation in note intensity ("dynamic performance," "expressive dynamics")
+- Performance energy: subtle, moderate, aggressive, intense
+- These pair with groove feel to shape the rhythmic character
+
+Arrangement:
+- Density: sparse, moderate, dense
+- Layering: single, stacked-doubles, octave, tripled, choir-layer
+- Instrument focus/lead: specify 1-2 instruments to foreground ("vocals and guitar forward," "synth-led")
+- Arrangement cues per section: "stripped," "building," "full," "minimal," "layered"
+
+=== CONFIRMED GENRES ===
+
+Electronic: House, Techno, Trance, Drum and Bass, Dubstep, Synthwave, Ambient, IDM, Glitch, Electro-Industrial
+Rock: Classic Rock, Hard Rock, Psychedelic Rock, Garage Rock, Post-Rock, Progressive Rock, Grunge, Alternative Rock, Indie Rock, Stoner Rock, Math Rock
+Metal: Heavy, Thrash, Death, Black, Doom, Sludge, Progressive, Symphonic, Nu-Metal, Metalcore, Industrial Metal
+Punk: Classic Punk, Hardcore, Post-Punk, Pop Punk, Garage Punk, Riot Grrrl, Crust, Horror Punk
+Hip-Hop/Rap: Boom Bap, Trap, Drill, Lo-Fi Hip Hop, Gangsta Rap, Alternative Hip Hop, Conscious Rap, Cloud Rap
+Pop: Mainstream Pop, Indie Pop, Synthpop, Electropop, Dance Pop, Bedroom Pop
+Jazz: Bebop, Cool Jazz, Free Jazz, Fusion, Swing, Latin Jazz, Avant-garde Jazz
+Blues: Delta Blues, Chicago Blues, Texas Blues, Blues Rock, Electric Blues, Modern Blues
+Folk: Traditional Folk, Indie Folk, Neo-Folk, Dark Folk, Acid Folk, Folk Rock
+Classical: Baroque, Romantic, Minimalist, 20th Century Avant-garde, Contemporary Classical, Film Score
+
+Genre Qualities (use to reinforce feel):
+- Rock: live-band feel, amp-driven dynamics, organic imperfections
+- Metal: palm-muted riffs, double-kick drumming, high-gain sustain
+- Punk: fast tempo, minimalist structure, chanted vocals, raw production
+- Electronic: quantized sequencing, layered synth textures, repetitive motifs
+- Hip-Hop: beat-driven loops, sampling culture, rhythmic vocal phrasing, 808 sub-bass emphasis
+- Pop: catchy topline, chorus-driven hooks, radio-friendly mix, accessible harmonies
+- Jazz: improvisational solos, extended harmonies, dynamic range, complex time signatures
+- Blues: 12-bar progressions, call-and-response, expressive bends, raw vocal tone
+- Folk: acoustic-driven, narrative lyrics, minimal production, cultural instrumentation
+- Classical: orchestral textures, counterpoint, dynamic crescendos, formal structures
+
+Genre Fusion: First genre dominates (~50%), subsequent blend with decreasing weight. For niche/uncommon genres, describe characteristics instead of naming:
+- "Witch house" -> "Dark electronic, occult atmosphere, chopped vocals, heavy reverb, slow tempo"
+- "Vaporwave" -> "Slowed-down, nostalgic, 80s samples, dreamy, lo-fi"
+- "Shoegaze" -> "Wall of guitars, heavy reverb, dreamy, distorted, buried vocals"
+
+Era modifiers: 70s, 80s, 90s, 2000s, retro, vintage, modern (place after genre to guide production style)
+
+=== VOCAL TREATMENT ===
+
+Gender/type: male, female, duet, choir, instrumental (specify "instrumental, no vocals" explicitly)
+Delivery: whispered, breathy, powerful, belting, raspy, soft, distant, intimate, reverb-heavy, auto-tuned, clean, gritty, conversational, melodic, aggressive, spoken
+Registers: soprano, mezzo-soprano, alto, tenor, baritone, bass, falsetto, head-voice, chest-voice
+Harmony: 2-part, 3-part, choir, call-and-response, stacked-doubles, octave-doubles
+Articulation: legato, staccato, crisp enunciation, slurred
+Vocal effects: plate reverb, delay, autotune (light/medium/heavy), vocoder, chorus
+Processing depth: none, light, medium, heavy
+Persona tags: [Persona: raspy-female], [Vocal: breathy, intimate] (place near top or before section)
+
+=== STRUCTURE TAGS & LYRICS FIELD ===
+
+Section tags (each on its own line): [Intro], [Verse], [Verse 1], [Verse 2], [Pre-Chorus], [Chorus], [Bridge], [Breakdown], [Drop], [Outro]
+Use unique labels to force different content: [Verse A], [Verse B]
+Bar counts: [Intro: 8 bars], [Verse: 16 bars], [Chorus: 8 bars]
+Performance cues inline in parentheses: (whispered), (belted), (rap), (spoken), (growl)
+Energy/mood tags: [Energy: High], [Energy: Low], [Mood: Dark], [Mood: Bright]
+Harmony tags: [Harmony: 3-part], [Harmony: stacked]
+Lyric tone tags: [LyricTone: blunt], [LyricTone: intimate]
+Chord progressions: [Chords: C G Am F] (above or inline with lyric lines)
+
+=== HARMONY, TEMPO & GROOVE ===
+
+Key: "minor key" and "major key" work reliably. Specific keys (A minor, C major) may work. Modes (Phrygian, Dorian) may influence but aren't literal. Best: pair key with emotional descriptor ("Minor key, dark, melancholic").
+Harmony style: diatonic, modal (dorian, mixolydian), chromatic, lush, sparse
+Tempo: Use BPM with descriptor ("140 BPM, driving"). Range 30-300.
+Groove feel: straight, swung, triplet, shuffle, laid-back, forward
+Drum style: straight, swing, shuffle, half-time, double-time, blast-beat
+Time signature: 4/4, 3/4, 6/8, 5/4, 7/8
+
+=== LANGUAGE, ACCENT & NARRATIVE ===
+
+Language: English, Spanish, French, German, Japanese, Portuguese, Italian
+Accent: american, british, irish, australian, canadian, regional
+Lyric tone/diction: conversational, poetic, formal, plainspoken, colloquial, ironic, direct
+Narrative POV: first, second, third, omniscient
+Localization: pair with instrumentation for regional cues (e.g., "Locale: Latin-America, hand percussion, congas")
+
+=== ADDITIONAL PARAMETERS ===
+
+Mood: calm, tense, aggressive, uplifting, melancholic, playful, serene, dark, energetic
+Intensity arc: steady, gradual build, sudden burst, rise-and-fall
+Emotional arc: calm -> tense -> release, melancholic -> uplifting (keep to 2-3 stages)
+Production style: clean, analog, lo-fi, modern, raw, polished
+Timbre: warm, bright, dark, clean, gritty, rounded, edgy
+
+=== PROMPT CONSTRUCTION PRIORITY ORDER ===
+
+Build style prompt in this order (stop at 350-400 chars):
+1. Primary genre + subgenre
+2. Secondary modifier / era
+3. BPM
+4. Key
+5. Mood words (2-3)
+6. Core instruments (2-3)
+7. Texture / production descriptors (1-2)
+8. Vocal treatment
+9. Humanization / performance feel
+10. Mix goals (if room)
+
+=== COMMON FIXES ===
+
+Wrong genre feel -> Move dominant genre to Position 1
+Flat/generic -> Add physical environment + vocal character + performance energy
+Too chaotic -> Remove contradictions, pick ONE dominant mood
+Vocals when unwanted -> Add "instrumental, no vocals" explicitly
+Overproduced -> Limit to 2-3 core instruments, specify "sparse" arrangement
+Robotic feel -> Add humanization cues ("loose feel," "organic imperfections," "live-band energy")
+
+=== OUTPUT ARCHITECTURE ===
+
+You MUST generate ALL of the following:
+
+1. SONG TITLE — A creative, evocative title that captures the essence of the song. Not generic. Should feel like a real song title that makes someone want to listen.
+
+2. STYLE PROMPT — the overall sonic identity (goes in Suno's Style Prompt field):
+   Template: [Primary genre], [secondary modifier]; [2-3 mood words]. [2-3 core instruments]; [1-2 texture adjectives]. Mix: [1-2 sonic goals]. Tempo: [BPM], Key: [key].
+   Include humanization/performance cues where appropriate ("live-band feel," "organic dynamics," "tight performance").
+   Keep under 400 chars. Put most important element in Position 1.
+
+3. LYRICS WITH TAGS — section-by-section structure (goes in Suno's Lyrics field):
+   Each section tag on its own line. Below each: performance/arrangement cues in brackets, then lyrics.
+   Include performance energy, arrangement density, and vocal delivery cues per section.
+   NEVER use em dashes in lyrics. Use commas, periods, or ellipses instead.
+
+4. SETTINGS — Weirdness (0-100) and Style Influence (0-100) recommendations for Suno's UI sliders. Include brief reasoning for each.
+
+5. COVER ART PROMPT — A rich, detailed image generation prompt for album cover art. This must be:
+   - 3-6 sentences of vivid visual description
+   - Directly inspired by the lyrics' imagery, metaphors, and emotional themes
+   - Specific about composition, lighting, color palette, textures, and atmosphere
+   - Include a visual style reference (e.g., "oil painting style," "cinematic photography," "collage aesthetic," "graphic novel illustration")
+   - Describe symbolic elements drawn from the song's narrative
+   - Suitable for AI image generation (Grok, Midjourney, DALL-E)
+   Do NOT just describe the genre. Paint a scene that tells the song's story visually.
+
+=== OUTPUT FORMAT ===
+
+You MUST respond with ONLY a JSON object, no other text. Format:
+{
+  "song_title": "the song title",
+  "style_prompt": "the complete style prompt text",
+  "lyrics": "the complete lyrics with section tags and cues",
+  "weirdness": 65,
+  "weirdness_reasoning": "brief reason",
+  "style_influence": 40,
+  "style_influence_reasoning": "brief reason",
+  "cover_art_prompt": "rich detailed image description for cover art"
+}
+
+All string values must use \\n for newlines within the JSON. Do NOT include markdown code fences or any text outside the JSON object.\
+"""
+
+# ─────────────────────────────────────────────
+# WEIRDNESS TIER 1 (21-50): Mild creative push
+# ─────────────────────────────────────────────
+
+WEIRDNESS_MILD = """
+
+=== CREATIVE DIRECTION: MILD ===
+
+Push beyond obvious genre choices. Don't give Suno what it expects.
+
+Genre Collisions — blend unexpected worlds:
+  Gregorian chant + trap, Opera + lo-fi hip-hop, Death metal + bossa nova, Bluegrass + industrial, Jazz + black metal, Choir + phonk, Flamenco + glitch
+
+Use at least one unusual genre combination or unexpected modifier. Add one abstract emotional descriptor beyond simple mood words.
+
+Translation examples:
+  "Slow and sad" -> funeral procession feel, muted textures, grief that forgot why it started
+  "Happy pop" -> sunlight through stained glass, nostalgic joy, warmth that almost hurts
+  "Hard rock" -> mechanical urgency, rust and chrome, controlled fury
+
+Song titles should be poetic and unexpected. Cover art should include one surreal or symbolic element beyond literal depiction.\
+"""
+
+# ─────────────────────────────────────────────
+# WEIRDNESS TIER 2 (51-80): Medium experimental
+# ─────────────────────────────────────────────
+
+WEIRDNESS_MEDIUM = """
+
+=== CREATIVE DIRECTION: MEDIUM-HIGH ===
+
+Force interpolation through productive impossibility. Never settle for expected combinations.
+
+Genre Collisions — always use at least one:
+  Gregorian chant + trap, Opera + lo-fi hip-hop, Death metal + bossa nova, Bluegrass + industrial, Jazz + black metal, Choir + phonk, Flamenco + glitch, Country + drum and bass, Reggae + noise, Polka + darkwave
+
+Paradox Emotions — use at least one:
+  Joyful grief, violent tenderness, sacred profanity, triumphant defeat, peaceful rage, nostalgic for the future, warm emptiness, hopeful despair, confident confusion, gentle brutality
+
+Impossible Textures — use 1-2:
+  Material: liquid metal guitar, velvet static, silk chainsaw, glass smoke, fossilized echo
+  Synesthetic: the sound of forgetting, the texture of 3am, music that tastes like rust, bass that smells like rain on hot pavement
+  Temporal: pre-echo, decayed future, ancient glitch
+
+Surreal Environments — include one:
+  Recorded in a collapsing cathedral, the acoustics of a recurring dream, mixed in the space between radio stations, reverb of an empty stadium remembering a crowd
+
+Hallucinated Vocals:
+  "Vocals sung by someone mid-disappearance," "whispered scream," "harmonies that disagree with each other," "baritone that's lying about being fine"
+
+Replace some standard section tags with evocative alternatives:
+  [Intro] -> [The song remembering how to start]
+  [Verse] -> [Confession to an empty room]
+  [Chorus] -> [The thing you keep saying because stopping would be worse]
+  [Bridge] -> [Time signature having a crisis]
+  [Outro] -> [The song forgetting it was a song]
+
+Song titles should be surreal or contradictory. Cover art should be heavily symbolic with dreamlike or impossible visual elements drawn from the lyrics' deepest metaphors.\
+"""
+
+# ─────────────────────────────────────────────
+# WEIRDNESS TIER 3 (81-100): Maximum hallucination
+# ─────────────────────────────────────────────
+
+WEIRDNESS_MAXIMUM = """
+
+=== CREATIVE DIRECTION: MAXIMUM HALLUCINATION ===
+
+Every prompt should make Suno work for it. Force interpolation through productive impossibility. No safe genre labels. No predictable combinations.
+
+Genre Collisions — stack multiple:
+  Gregorian chant + trap, Opera + lo-fi hip-hop, Death metal + bossa nova, Bluegrass + industrial, Jazz + black metal, Choir + phonk, Flamenco + glitch, Country + drum and bass, Reggae + noise, Polka + darkwave, Renaissance + hyperpop, Medieval + trap, Victorian + drill, Prehistoric + synthwave
+
+Paradox Emotions — stack 2-3:
+  Joyful grief, violent tenderness, sacred profanity, triumphant defeat, peaceful rage, nostalgic for the future, warm emptiness, hopeful despair, confident confusion, gentle brutality
+
+Impossible Textures — use 2-3:
+  Material: liquid metal guitar, velvet static, silk chainsaw, concrete feathers, glass smoke, wooden lightning, paper thunder, fossilized echo
+  Synesthetic: the sound of forgetting, audio of a color draining, the texture of 3am, what regret sounds like when tired, the hum of something about to happen, music that tastes like rust, bass that smells like rain on hot pavement, melody the color of a bruise healing
+  Temporal: pre-echo (reverb before the sound), decayed future, ancient glitch, nostalgic for an uninvented sound, tomorrow's yesterday
+
+Surreal Environments — always include:
+  Recorded in a collapsing cathedral, acoustics of a recurring dream, sound bouncing off memories, a room that keeps forgetting its shape, the space between radio stations, echo from an unbuilt building, reverb of an empty stadium remembering a crowd, underwater bonfire, ambience of deja vu
+
+Impossible Instruments:
+  Piano with opinions, drums that hesitate, bass that apologizes, guitar that's lying, synth that's grieving, strings that remember something else, horns having a crisis, vocals from someone who forgot the words but kept singing
+
+Hallucinated Structure Tags — replace ALL standard tags:
+  [Intro] -> [The song remembering how to start]
+  [Verse] -> [Confession to an empty room]
+  [Pre-Chorus] -> [Moment before admitting it]
+  [Chorus] -> [The thing you keep saying because stopping would be worse]
+  [Bridge] -> [Time signature having a crisis]
+  [Breakdown] -> [Everything realizing it was wrong]
+  [Drop] -> [Floor remembers it's not there]
+  [Outro] -> [The song forgetting it was a song]
+
+Hallucinated Vocals — always use impossible voice descriptors:
+  "Vocals sung by someone mid-disappearance," "voice of someone who just realized something terrible," "singing like trying to remember a melody while losing it," "whispered scream, screamed whisper," "choir of one person interrupting themselves," "falsetto having second thoughts"
+
+  Voice + impossible state combos: Male baritone "sung while dissolving," Female soprano "underwater and apologizing," Chanting "monks who forgot the prayer halfway," Belting "exhausted, running on nothing"
+
+Abstract Directives — end every style prompt with one:
+  "Music for ghosts who forgot they died," "a lullaby that keeps you awake," "dance music for people who forgot how to move," "the sound of almost calling someone back," "what plays in the background of a memory you edited," "music that sounds like it's been left in the rain," "a song that keeps apologizing for itself," "what the static between stations dreams about," "music for a party where everyone already left," "the score to a movie that was never made"
+
+Arrangement Chaos Cues:
+  "Instruments enter like they showed up to the wrong gig," "build that doesn't know where it's going," "drop that apologizes," "chorus that gets quieter instead of louder," "outro that keeps almost ending"
+
+Song titles should be impossible phrases or paradoxes. Cover art should be fully surreal: impossible geometry, melting realities, scenes that couldn't physically exist but perfectly capture the song's emotional DNA. Draw every visual element from the lyrics' imagery and metaphors.\
+"""
+
+
+def build_system_prompt(weirdness: int) -> str:
+    """Build the full system prompt based on weirdness level (0-100)."""
+    prompt = BASE_PROMPT
+
+    if weirdness <= 20:
+        prompt += "\n\n=== CREATIVE DIRECTION ===\nKeep the prompt straightforward and conventional. Use standard genre labels, clear mood words, and proven instrument combinations. Focus on clarity and reliability over experimentation. Song titles should be clear and memorable. Cover art should be vivid and atmospheric but grounded in realistic imagery that matches the song's themes."
+    elif weirdness <= 50:
+        prompt += WEIRDNESS_MILD
+    elif weirdness <= 80:
+        prompt += WEIRDNESS_MEDIUM
+    else:
+        prompt += WEIRDNESS_MAXIMUM
+
+    return prompt

requirements.txt

@@ -0,0 +1,3 @@
+gradio
+openai
+python-dotenv