https://github.com/the0cp/beatflow
Web-based AI music generator that plans full song arrangements based on music theory, offering in-browser Piano Roll for editing multi-track MIDI instead of just generating static audio.
https://github.com/the0cp/beatflow
ai-music algorithm-composition beat-maker creative-tools daw fastapi generative-ai llm midi-export midi-generator music-generator music-production music-theory nextjs open-ai piano-roll react text-to-midi web-audio
Last synced: 3 months ago
JSON representation
Web-based AI music generator that plans full song arrangements based on music theory, offering in-browser Piano Roll for editing multi-track MIDI instead of just generating static audio.
- Host: GitHub
- URL: https://github.com/the0cp/beatflow
- Owner: the0cp
- Created: 2026-02-15T15:46:47.000Z (4 months ago)
- Default Branch: master
- Last Pushed: 2026-03-13T09:23:35.000Z (3 months ago)
- Last Synced: 2026-03-13T17:54:49.730Z (3 months ago)
- Topics: ai-music, algorithm-composition, beat-maker, creative-tools, daw, fastapi, generative-ai, llm, midi-export, midi-generator, music-generator, music-production, music-theory, nextjs, open-ai, piano-roll, react, text-to-midi, web-audio
- Language: Python
- Homepage:
- Size: 11.1 MB
- Stars: 6
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# BeatFlow: AI Full Arrangement Generator
BeatFlow is an LLM-powered music prototyping tool. Enter a prompt and it generates multi-track MIDI arrangements (chords, bass, drums). It features a full in-browser Piano Roll for editing, playback, and direct MIDI export to your DAW.
BeatFlow is not an MP3 generator. It utilizes the LLM as a Music Director capable of genuine music theory reasoning. Instead of predicting waveforms, the LLM architects a complete musical structure—planning sections, energy curves, and harmonic progressions—before composing. The output is a fully editable, structurally coherent MIDI arrangement.
- Includes a fully functional web-based Piano Roll editor.
- Export standard MIDI files to drop directly into Ableton Live, FL Studio, or Logic Pro.
- Uses LLMs to understand music theory, generating structured sections (Intro, Groove, Breakdown) rather than random notes.
## Quick Deployment
The project is split into a Frontend (Next.js) and Backend (FastAPI).
- Python 3.10+
- Node.js 18+ (pnpm recommended)
### Backend Setup (Python/FastAPI)
```bash
cd beatflow
pip install -r requirements.txt
```
Configure Environment:
Create a `.env` file and add:
```text
OPENROUTER_API_KEY=your_key
LLM_BASE_URL=https://openrouter.ai/api/v1 # (or other OpenAI-compatible endpoint)
LLM_MODEL=your_model_name # (e.g., gpt-4o, gemini-3-pro)
# Optional proxy settings
HTTP_PROXY=
HTTPS_PROXY=
```
Start server:
```bash
python main.py
```
### Frontend Setup (Next.js)
```bash
cd frontend
pnpm install
pnpm dev
```
Open `http://localhost:3000` to start creating.