mcpField
F
fal-music

fal-music

github.com/idanbeckCreative & media1442 installsUpdated 2d ago
Repository

About fal-music

fal-music is a command-line skill for generating music through FAL.ai models. It lets users choose among Stable Audio Open, Stable Audio 2.5, and Beatoven Maestro and save generated audio locally.

Key features

  1. 01Generate music from text prompts
  2. 02Choose among three FAL.ai models
  3. 03Set duration, guidance, and creativity
  4. 04Set negative prompts and random seeds
  5. 05Save generated audio locally

Use cases

  1. 01Create a short musical loop or sound effect
  2. 02Generate a full track from a genre and mood
  3. 03Produce ambient or electronic music at a specified duration

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/idanbeck/claude-skills --skill fal-music

After installing, type/fal-musicin Claude Code to confirm it loaded.

Bundled filesfal_music_skill.py

Details

From the project README

FAL Music - AI Music Generation

Generate music using FAL.ai — access to Stable Audio Open, Stable Audio 2.5, and Beatoven Maestro through a single API.

Setup

Uses the same FAL API key as fal-video-skill. If not already configured:

python3 ~/.claude/skills/fal-music-skill/fal_music_skill.py config YOUR_API_KEY

Or set environment variable:

export FAL_KEY="your_api_key"

Commands

Generate Music
python3 ~/.claude/skills/fal-music-skill/fal_music_skill.py generate "your prompt" [OPTIONS]

Arguments:

  • PROMPT - Music description (e.g., "dark synthwave with driving bass and arpeggiated synths")
  • --model, -m - Model to use (default: stable-audio-25)
  • --duration, -d - Duration in seconds (default: 60)
  • --steps, -s - Inference/refinement steps
  • --guidance, -g - Guidance scale (stable-audio-25 only)
  • --creativity - Creativity level 1-20 (beatoven only)
  • --negative-prompt, -n - What to avoid (beatoven only)
  • --seed - Random seed for reproducibility
  • --output, -o - Output file path
  • --timeout, -t - Timeout in seconds (default: 300)

Examples:

# Synthwave track
python3 fal_music_skill.py generate "dark synthwave instrumental, driving bassline, analog arpeggios, 120 BPM" -d 90

# Ambient music with Beatoven
python3 fal_music_skill.py generate "ambient electronic, atmospheric pads, gentle evolving textures" -m beatoven -d 120

# Short loop with Stable Audio Open
python3 fal_music_skill.py generate "128 BPM techno drum loop with acid bass" -m stable-audio -d 30

# Custom output path
python3 fal_music_skill.py generate "epic orchestral trailer music" -o ~/music/trailer.wav
List Models
python3 ~/.claude/skills/fal-music-skill/fal_music_skill.py models
Check Config
python3 ~/.claude/skills/fal-music-skill/fal_music_skill.py config

Available Models

ModelQualityMax DurationCostBest For
stable-audioGood47sFreeLoops, SFX, short clips
stable-audio-25Excellent190s~$0.20/genFull tracks, high quality
beatovenBest150sVariesFull songs, compositions

Output

Audio files saved to ~/.claude/skills/fal-music-skill/output/ by default.

JSON output includes:

{
  "status": "success",
  "model": "stable-audio-25",
  "file": "/path/to/audio.wav",
  "url": "https://fal.media/...",
  "duration": 60,
  "prompt": "..."
}

Prompt Tips

Good prompts for music generation:

  • Include genre: "synthwave", "ambient", "techno", "orchestral"
  • Specify tempo: "120 BPM", "slow tempo", "driving rhythm"
  • Mention instruments: "analog synths", "electric guitar", "piano"
  • Describe mood: "dark", "uplifting", "melancholic", "energetic"
  • Add "instrumental" to avoid vocals

Requirements

requests>=2.28.0

Security Notes

  • API key stored in config.json with 600 permissions
  • Falls back to fal-video-skill config if own config not set
  • Audio files downloaded locally, URLs expire after ~24 hours

#music #ai #fal #audio #generation

Comments

Markdown supported