RemixFlow — backend

FastAPI backend for the RemixFlow music-evolution platform. See the repo-root README.md for the full picture; this file covers the Python package.

Install

pip install -e ".[audio,dev]"   # audio extra adds librosa (tempo/pitch/key)

Core deps are pure PyPI wheels. The bundled libsndfile (via soundfile) reads and writes MP3/WAV/FLAC/OGG with no system packages — no ffmpeg needed. The audio extra pulls in librosa for tempo/key detection and time-stretch/pitch-shift.

Run

remixflow serve                 # http://127.0.0.1:8770  (API + built UI)
remixflow serve --reload        # dev auto-reload

Interactive API docs at /docs.

Layout

Adding a real model backend

Implement Generator and register it:

from remixflow.generation import Generator, register_generator

class AceStepBackend(Generator):
    name = "ace-step"
    description = "ACE-Step 1.5 diffusion"
    def generate(self, parent, steering, *, original=None, seed=None):
        ...  # map steering -> latent edits, run the model, return GenerationResult

register_generator(AceStepBackend())

It then appears in /api/backends and is selectable via POST /api/generate?backend=ace-step.

Config (env vars)