RehearseKit

Your Complete Rehearsal Toolkit

Transform any audio source into a ready-to-use rehearsal project in minutes. RehearseKit automatically separates stems, detects tempo, and generates DAW project files—so you can focus on making music.

---

✨ Features

Core Functionality

• 🎵 Audio Input: Upload MP3, WAV, or FLAC files, or paste YouTube URLs
• 🎼 AI Stem Separation: Isolate vocals, drums, bass, and other instruments using Demucs
• ⏱️ Tempo Detection: Automatic BPM analysis with manual override
• ✂️ Waveform Trimming: Visual region selection to process only specific portions
• 🎹 DAW Integration: Auto-generated .dawproject files (Studio One, Bitwig, Reaper, Cubase)

Advanced Features (Stage 3)

• 🎚️ Professional DAW Mixer: Multi-channel mixer with vertical faders, solo/mute, and real-time preview
• 🔄 Quality Upgrade: One-click reprocessing from fast to high quality mode
• 📦 Download Packages: All stems + project file in organized ZIP structure
• 🎨 Modern UI: Dark theme with professional DAW-style interface

Coming Soon (Stage 4)

• 🔐 Authentication: Google OAuth + optional email/password
• 👤 User Accounts: Job history and personalized experience
• 🚀 Self-Hosted: Deploy locally or on TrueNAS for zero cloud costs

---

🚀 Quick Start

Using Docker (Recommended)

1. Clone and configure

   git clone https://github.com/UnTypeBeats/RehearseKit.git
   cd RehearseKit
   cp config/.env.example .env
   # Edit .env with your configuration

2. Start all services

   docker-compose up

3. Access the application

   • Frontend: http://localhost:3000
   • Backend API: http://localhost:8000
   • API Docs: http://localhost:8000/docs

Prerequisites

• Docker Desktop (Mac) or Docker Engine (Linux/WSL)
• 8GB+ RAM recommended for AI processing
• ~10GB disk space for models

For detailed setup instructions, see docs/guides/local-development.md

---

📁 Project Structure

RehearseKit/
├── frontend/              # Next.js 14 application
├── backend/               # FastAPI application + Celery workers
├── websocket/             # WebSocket service for real-time updates
├── infrastructure/        # Deployment configurations (Terraform, TrueNAS)
├── docs/                  # Documentation
│   ├── guides/            # User and developer guides
│   ├── api/               # API documentation
│   ├── archive/           # Historical documentation
│   └── ideas/             # Feature proposals
├── scripts/               # Deployment and setup scripts
├── config/                # Configuration templates
│   ├── .env.example       # Environment variables template
│   ├── docker-compose.dev.yml
│   └── docker-compose.prod.yml
└── docker-compose.yml     # Local development setup

---

🏗️ Architecture

Technology Stack

• Frontend: Next.js 14, React Query, WaveSurfer.js, Web Audio API, shadcn/ui
• Backend: FastAPI, SQLAlchemy, Celery, Alembic
• AI/Audio: Demucs (stem separation), librosa (tempo detection), FFmpeg, yt-dlp
• Infrastructure: Docker, PostgreSQL 16, Redis 7
• Deployment: TrueNAS SCALE, Cloudflare Tunnel

Service Architecture

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   Frontend  │────▶│  Backend    │────▶│   Worker    │
│  (Next.js)  │     │  (FastAPI)  │     │  (Celery)   │
└─────────────┘     └─────────────┘     └─────────────┘
       │                   │                    │
       │            ┌──────┴──────┐            │
       │            │             │            │
       ▼            ▼             ▼            ▼
┌─────────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐
│  WebSocket  │  │PostgreSQL│  │  Redis  │  │ Storage │
│   Service   │  │    16   │  │    7    │  │  Local  │
└─────────────┘  └─────────┘  └─────────┘  └─────────┘

---

📖 Documentation

• Quick Start Guide - Get started in 5 minutes
• Development Guide - Contributing and development setup
• Deployment Guide - Production deployment options
• TrueNAS Deployment - Self-hosted setup
• Cubase Import Guide - DAW project import
• API Documentation - REST API reference

---

🚢 Deployment

TrueNAS SCALE (Recommended for Self-Hosting)

# See docs/guides/truenas-deployment.md for complete instructions
cd infrastructure/truenas
./deploy.sh

Docker Compose (Production)

# Use production configuration
docker-compose -f config/docker-compose.prod.yml up -d

Deployment Scripts

All deployment scripts are located in scripts/deployment/:

• deploy-truenas.sh - TrueNAS deployment automation
• build-and-push.sh - Build and push Docker images

---

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for:

• Code of conduct
• Development workflow
• Pull request process
• Coding standards

---

📊 Current Status

Version: Stage 3 Complete (Stage 4 in progress)
Status: Production Ready ✅
Live Demo: rehearsekit.uk

Stage 3 Features (Completed)

• ✅ Waveform trimming with visual feedback
• ✅ Professional DAW-style mixer
• ✅ Quality upgrade workflow
• ✅ Cubase import integration

Stage 4 Features (In Progress)

• 🔄 Authentication system (Google OAuth)
• 🔄 User accounts and job ownership
• 🔄 Repository cleanup and reorganization

---

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

🙏 Acknowledgments

• Demucs - AI-powered stem separation
• WaveSurfer.js - Audio waveform visualization
• shadcn/ui - Beautiful UI components
• FastAPI - Modern Python web framework

---

📧 Support

• Documentation: docs/
• Issues: GitHub Issues
• Live Site: rehearsekit.uk

---

Built with ❤️ for musicians who want to spend less time on setup and more time making music.