README.md

metadata

title: BeatForge
emoji: 🎚️
colorFrom: red
colorTo: blue
sdk: gradio
sdk_version: 5.24.0
python_version: '3.10'
app_file: app.py
pinned: true
license: mit
short_description: Lyrics-to-music studio by Bilal Ansari.
tags:
  - music
  - audio
  - gradio
  - lyrics-to-music
  - generative-audio

BeatForge

BeatForge is a Hugging Face free-tier music generation studio by Bilal Ansari.

Website: ansaribilal.com

The original Colab concept targets HeartMuLa 3B BF16 on a T4 GPU. This Space is built for Hugging Face CPU Basic, so it ships with a CPU-native procedural composition engine that turns structured lyrics and style tags into an original instrumental track. It keeps the same product shape: lyrics, tags, generation controls, branded output, and upgrade notes for the HeartMuLa/MusicGen backend path.

Run The Full HeartMuLa 3B Model

The free Hugging Face Space runs the CPU-compatible BeatForge engine. For the full HeartMuLa 3B BF16 workflow, run the Colab notebook on a T4 GPU:

Open BeatForge Full Model Colab

Why Not HeartMuLa 3B Directly On Free HF CPU?

Hugging Face CPU Basic provides 2 vCPU, 16 GB RAM, and no GPU. HeartMuLa 3B BF16 is a large GPU-oriented model, and the Colab setup depends on T4-class VRAM plus packages such as flash-attn. This Space avoids that fragile stack so it can actually build and run on the free tier.

What This Version Generates

• Original instrumental tracks from lyrics and style tags
• Section-aware arrangements using [Intro], [Verse], [Chorus], [Bridge], and [Outro]
• Drums, bass, chords, melody, pads, and texture layers
• WAV or MP3 export
• Brand-forward UI with ansaribilal.com attribution

Upgrade Path

For neural lyrics-to-music quality, upgrade the Space to GPU and replace the CPU engine with one of these backends:

• HeartMuLa 3B BF16 with lazy loading
• MusicGen Small/Medium with a GPU runtime or hosted endpoint
• A private inference endpoint exposed through HF_TOKEN

The UI is designed so the generation backend can be swapped without changing the user experience.