audioforge

🔊 AudioForge — AI Audio Generator CLI

Multi-provider AI sound effect & music generation from your terminal.

• 4 Providers: ElevenLabs, Stability AI, fal.ai, Replicate
• Sound Effects: Game sounds, UI clicks, foley, ambient noise
• Music Generation: Background music, loops, tracks with genre/BPM control
• 15 Style Presets: game-sfx, cinematic, 8-bit, ambient, electronic, orchestral...
• Batch Processing: Generate multiple audio files from YAML config
• Templates: Save prompts with {variables} for repeatable generation
• Cost Tracking: Per-provider spending summaries
• History: Full generation log with search

Quick Start

npm install -g audioforge

# Configure a provider
audioforge config set elevenlabs.apiKey sk-your-key

# Generate a sound effect
audioforge gen "laser beam shooting"

# Generate with a style preset
audioforge gen "footsteps on gravel" --preset game-sfx

# Generate music
audioforge music "lo-fi hip hop beat" --genre ambient --duration 30

# Compare providers
audioforge compare "thunder rumble"

Commands

Sound Effects

audioforge generate <prompt>         # (alias: gen, g)
  -p, --provider <name>              # elevenlabs, stability, fal, replicate
  -m, --model <model>                # Specific model
  -d, --duration <seconds>           # Duration or preset (blip, short, medium...)
  -o, --output <path>                # Output file path
  -f, --format <type>                # wav, mp3, ogg, flac (default: wav)
  -s, --preset <style>               # Style preset (game-sfx, cinematic, 8-bit...)
  -t, --template <name>              # Use saved prompt template
  -v, --var <key=value>              # Template variable (repeatable)
  --seed <number>                    # Seed for reproducibility
  --loop                             # Generate seamless loop
  --open                             # Open audio after generation

Music

audioforge music <prompt>            # (alias: m)
  -p, --provider <name>              # stability, fal, replicate
  -d, --duration <seconds>           # Duration (default: 30)
  --genre <genre>                    # ambient, electronic, orchestral, rock...
  --bpm <bpm>                        # Tempo in BPM
  --instrumental                     # Instrumental only, no vocals
  --loop                             # Seamless loop

Other Commands

audioforge compare <prompt>          # Compare across providers
audioforge batch <file.yaml>         # Batch generate from YAML/JSON
audioforge convert <input> --to mp3  # Convert audio format
audioforge providers list            # List all providers
audioforge history list              # View generation history
audioforge template save <n> <p>     # Save prompt template
audioforge cost summary              # Spending summary
audioforge cost pricing              # Per-provider pricing
audioforge config set <key> <val>    # Set configuration
audioforge config list               # Show all config

Providers

Provider	Models	Capabilities	API Key
ElevenLabs	eleven_sfx_v2	SFX, Loop	elevenlabs.apiKey
Stability AI	stable-audio-2.5	SFX, Music (up to 3 min)	stability.apiKey
fal.ai	CassetteAI, Beatoven	SFX, Music	fal.apiKey
Replicate	MusicGen, AudioGen	SFX, Music, Variations	replicate.apiKey

Setup

audioforge config set elevenlabs.apiKey "your-elevenlabs-key"
audioforge config set stability.apiKey "your-stability-key"
audioforge config set fal.apiKey "your-fal-key"
audioforge config set replicate.apiKey "your-replicate-key"

Style Presets

Preset	Description
game-sfx	Punchy, clear, game-ready sound effect
ui-click	Subtle, satisfying UI interaction sound
ambient	Atmospheric environmental ambience
cinematic	Dramatic, theatrical sound design
foley	Realistic everyday sound recording
8-bit	Retro chiptune pixel game sound
sci-fi	Futuristic, technological sound
fantasy	Magical, ethereal, enchanting sound
horror	Dark, unsettling, eerie atmosphere
electronic	Synthesized, modern electronic sound
orchestral	Classical orchestral instruments
lo-fi	Warm, vintage, relaxing lo-fi sound
notification	Short, attention-grabbing alert
transition	Smooth whoosh/sweep transition
nature	Natural environmental outdoor sound

Duration Presets

Preset	Duration
blip	0.5s
short	2s
medium	5s
long	10s
extended	30s
music-short	15s
music-medium	30s
music-long	60s
music-full	180s

Batch Processing

Create a YAML file:

items:
  - prompt: "laser beam"
    type: sfx
    provider: elevenlabs
    duration: 3
  - prompt: "ambient piano loop"
    type: music
    provider: stability
    duration: 30

audioforge batch sounds.yaml
audioforge batch sounds.yaml --dry-run  # Preview only

Templates

# Save a template with variables
audioforge template save game-hit "{material} impact on {surface}" --preset game-sfx

# Use the template
audioforge gen "" -t game-hit -v material=metal -v surface=concrete

# List and manage
audioforge template list
audioforge template show game-hit
audioforge template delete game-hit

Part of the Forge Ecosystem

Tool	Purpose
AppForge	Scaffold projects
BackForge	Backend init
TestForge	AI test generation
ImgForge	AI image generation
AudioForge	AI audio generation
ScreenForge	App store assets
StoreForge	Store deployment
MonForge	Production monitoring

License

MIT © magicpro97