whatisgithub

What is waivepulse?

weellio/waivepulse — explained in plain English

Analysis updated 2026-05-18

7HTMLAudience · vibe coderComplexity · 4/5Setup · hard

In one sentence

An offline, local AI tool that turns lyrics and style tags into a full song with vocals, plus a stem-separation studio for remixing it.

Mindmap

mindmap
  root((WAIvePulse))
    What it does
      Generates songs from lyrics and tags
      Runs fully offline
      Separates songs into stems
    Tech stack
      Python
      HeartMuLa 3B model
      CUDA GPU
    Use cases
      Songwriting from lyrics
      Stem remixing
      Karaoke tracks
    Audience
      Vibe coders
      Hobbyist musicians
    Requirements
      NVIDIA GPU with CUDA
      Windows or Linux only

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Generate a complete song with vocals from written lyrics and genre tags.

USE CASE 2

Separate a generated song into individual stems like vocals, drums, and bass.

USE CASE 3

Make a karaoke or acapella version of a generated track with one click.

What is it built with?

PythonHTMLHeartMuLa 3BCUDA

How does it compare?

weellio/waivepulsepajkegit/epic-sword-forgeronit049/find-the-perfect-blinkit-location
Stars777
LanguageHTMLHTMLHTML
Setup difficultyhardeasyeasy
Complexity4/51/51/5
Audiencevibe coderdesignerpm founder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Needs an NVIDIA GPU with about 10GB VRAM and CUDA, downloads roughly 21GB of model weights, no macOS support.

So what is it?

WAIvePulse is a local, fully offline AI music generation tool. You give it structured lyrics using section markers like [Verse], [Chorus], and [Bridge], plus a set of style and genre tags, and it produces a complete song with vocals as an MP3, all running on your own machine with no cloud service or subscription. The tool serves a web interface at http://localhost:7860. When you submit a request, it works through two phases: the HeartMuLa 3B language model generates audio tokens from your lyrics and tags, then a codec converts those tokens into an audio waveform. You can queue multiple songs while one is generating. Each completed card shows the detected BPM and musical key, an audio player with several visualizer styles, and a download button. A built-in Studio page lets you separate any generated song into six stems: vocals, drums, bass, guitar, piano, and other, and mix them independently. You can mute, solo, and adjust volume per stem, or use one-click presets like Karaoke (vocals off) or Acappella (instruments off). Tags are the main way to shape the sound. The model was trained with eight categories: Genre, Timbre, Gender, Mood, Instrument, Scene, Region, and Topic. The key rule is one tag per category: stacking multiple genre tags produces muddier output. Setup downloads the model weights automatically (about 21 GB total). Requirements include Python 3.10 or newer, an NVIDIA GPU with roughly 10 GB of VRAM (CUDA required), and either Windows or Linux, macOS is not supported. The full README is longer than what was provided.

Copy-paste prompts

Prompt 1
How do I write lyrics with section markers so WAIvePulse can turn them into a song?
Prompt 2
What tags should I use to get a specific genre and mood from WAIvePulse?
Prompt 3
Explain how WAIvePulse separates a generated song into stems in the Studio page.
Prompt 4
What GPU and software do I need installed to run WAIvePulse locally?

Frequently asked questions

What is waivepulse?

An offline, local AI tool that turns lyrics and style tags into a full song with vocals, plus a stem-separation studio for remixing it.

What language is waivepulse written in?

Mainly HTML. The stack also includes Python, HTML, HeartMuLa 3B.

How hard is waivepulse to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is waivepulse for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.