Skip to content

About

Local-first AI music workstation (FastAPI + ACE-Step). Parked pending GPU.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

FlowForge Music Studio — MVP

Status: parked. Working code, wrong time. It needs a locally running ACE-Step 1.5 server (CUDA GPU) to do anything, and the AI music channel it was built for is a back-burner project. Kept here as a record of the engineering — FastAPI backend, real audio pipeline, honest scope.

A local-first AI music workstation built around your two core ideas:

  • Kinetic Flow: still → moving, rather than quiet → loud.
  • Lock-In Loop: repeatable, predictable cycles where anticipation and payoff happen in a familiar place.

FlowForge does not require a paid music API. It connects to a locally running ACE-Step 1.5 server.

What this MVP already does

  • Local text-to-music generation through ACE-Step 1.5
  • Kinetic Flow, Lock-In Loop, Cinematic Tension and Custom presets
  • Controls for movement, tension, rhythmic density and predictability
  • Instrumental-first prompting
  • 1–4 minute master generation
  • WAV / MP3 / FLAC output selection
  • Optional BPM and seed control
  • In-app job polling and playback
  • 10, 30 and 60 minute repeated loop export via ffmpeg

1. Install / run ACE-Step 1.5 locally

ACE-Step's current official project exposes a local REST API. The default FlowForge connection is:

http://127.0.0.1:8001

Typical ACE-Step setup:

git clone https://github.com/ACE-Step/ACE-Step-1.5.git
cd ACE-Step-1.5
uv sync
uv run acestep-api

ACE-Step will download model files on first use. A CUDA GPU is recommended, but ACE-Step also documents other backends.

If you run ACE-Step on another URL, set ACE_STEP_URL before launching FlowForge.

Windows example:

set ACE_STEP_URL=http://127.0.0.1:8001
run_windows.bat

2. Start FlowForge

Windows

Double-click:

run_windows.bat

macOS / Linux

./run_mac_linux.sh

Then open:

http://127.0.0.1:8090

3. Optional: install ffmpeg for 10/30/60-minute exports

Generation works without ffmpeg. Long-loop export uses ffmpeg.

On Windows, install ffmpeg and make sure ffmpeg.exe is on PATH.

How the presets are meant to work

Kinetic Flow

For cinematic, choreographic instrumentals: tension becomes motion. The payoff is fluidity and forward movement, not just loudness.

Lock-In Loop

For repeatable focus/training/background tracks. The cycle is intentionally predictable and the ending is prompted to reconnect naturally with the beginning.

Cinematic Tension

For patient dramatic underscore with negative space and an earned release.

Important note about references

Do not feed copyrighted soundtrack audio into reference/cover modes unless you have the rights to do so. FlowForge's default workflow uses abstract musical qualities and original prompts rather than copying a source track.

Next logical upgrades

  1. True seamless-loop editor with waveform trim + crossfade
  2. Reference-analysis mode for audio you own
  3. "Payoff position" and "cycle length" controls
  4. Track history/library with favorite generations and seeds
  5. Side-by-side A/B variations from the same seed
  6. Stem separation and per-stem regeneration
  7. LoRA/style-profile support for your own legally controlled training material
  8. Desktop packaging so it launches like a normal app

About

Local-first AI music workstation (FastAPI + ACE-Step). Parked pending GPU.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages