ForgeDeck

Web DJ / DAW — две деки как у CDJ, продакшен в браузере.

Драм-машина · синтез · Session / Arrange · Rubber Band key lock · stems · AI Producer

Realtime-звук только в браузере (Web Audio). Python хранит проекты, анализ, AI и export.

Стек

Слой	Технологии
Backend	Python 3.12, FastAPI, SQLAlchemy, Alembic, Pydantic
DB	SQLite (dev) / PostgreSQL (Docker)
Jobs	Redis + Celery (опционально; без Redis анализ в потоке)
Audio (offline)	soundfile, numpy, scipy, ffmpeg; librosa опционально
Frontend	React 18, TypeScript, Vite, Tailwind, Zustand
Engine	Web Audio API, Rubber Band WASM key lock, AudioWorklet bitcrusher, analog/convolution FX, Web MIDI

Быстрый старт на Windows

В папке bat/ — скрипты для двойного клика:

1. Один раз (или сразу start.bat — он сам доустановит): bat\setup.bat создаёт .venv, копирует .env, ставит Python- и npm-зависимости, пишет демо-wav.
2. bat\start.bat поднимает API и UI в двух окнах и открывает http://127.0.0.1:5173
3. Остановка: кнопка Выключить в приложении, закрыть окна или bat\stop.bat

Нужен Python 3 (галочка Add to PATH). bat\setup.bat ищет Node.js LTS в обычных установках и version managers (nvm/fnm/Volta/Scoop), а если его нет — пробует поставить через winget или Chocolatey. Docker — отдельно: bat\start-docker.bat.

Быстрый старт на macOS

В папке mac/ — .command для двойного клика в Finder (откроется Terminal):

1. Один раз (или сразу start.command): mac/setup.command
2. mac/start.command — API + UI в двух окнах и браузер на http://127.0.0.1:5173
3. Остановка: кнопка Выключить в приложении, закрыть окна или mac/stop.command

Нужны python3 и Node.js (с python.org / nodejs.org или brew install python node). Если setup.command пишет «Не найден Node.js» — это окно Finder без ~/.zshrc: поставь LTS с nodejs.org или Homebrew; скрипт сам попробует brew install node. Gatekeeper: правый клик → Открыть. Docker — mac/start-docker.command.

Быстрый старт (local, SQLite)

cp .env.example .env

# Backend
python3 -m pip install -r backend/requirements.txt
cd backend
PYTHONPATH=..:. uvicorn app.main:app --reload --port 8000

# Frontend (другой терминал)
cd frontend
npm install
npm run dev

Открой http://localhost:5173. API-документация: http://localhost:8000/docs.

Логин: http://localhost:5173/login — demo [email protected] / demo (пока REQUIRE_AUTH=false, API принимает и запросы без токена).

Создай проект → студия сразу кладёт демо-петлю на Deck A. Кликни по UI (браузер разблокирует AudioContext) → Play. Свой трек: Library Upload (mp3/wav/flac/ogg).

Docker Compose

cp .env.example .env
docker compose up --build

Сервисы: PostgreSQL, Redis, backend :8000, Celery worker, frontend :5173 (nginx).

Архитектура

/backend        FastAPI, модели, REST, WebSocket, JWT, presets
/frontend       React UI
  /src/audio-engine   Transport, Deck, Mixer, FX, Drums, Synth, Timeline
/workers        Celery: analyze, render, stems (GPU Demucs → CPU Demucs → HPSS)
/ai_agents      Orchestrator + tools + mock LLM
/storage/audio  файлы для dev (опционально S3)

Поток загрузки:

1. POST /api/audio/upload сохраняет файл (локально, затем S3 если задан bucket)
2. Анализ (miniaudio для mp3, soundfile для wav/flac) считает duration, waveform, BPM, beats, key, RMS/peak, energy 1–10, mix-in/mix-out
3. Frontend рисует waveform + beatgrid и играет через decodeAudioData

Режимы UI

• DJ — деки, vinyl platter/scratch, overview+zoom waveform, crate/queue (energy + mix-in/out, next-track highlight), cue/hot cues, loop in/out, loop roll, Rubber Band key lock, beat jump, quantize, sync, instant doubles, crossfader curve, EQ kills, gain match, beat offset / Q-sync, echo out, EQ/filter/FX-пресеты, pan/mute/solo, FX send/return, sidechain, stem rack (ISO, drag stem), mic/line-in, PFL / cue mix / split cue, отдельное cue-окно и выбор выходного устройства без запроса микрофона
• Session — clip launcher на 8 сцен; те же drums / synth / Deck A/B и добавляемые audio-дорожки, что в Arrange; drop петли (warp to BPM), Session rec / Capture to arrange
• Arrange — клипы drums/synth/audio (warp), snap bar/beat/1/8, zoom, duplicate/copy/paste, drag между дорожками, fade in/out, automation lanes и production console
• Drums — 16 падов, sequencer 16/32/64, paint + velocity graph, swing, save pattern/kit, edit lock, drop стема на пад
• Synth — OSC/ADSR/filter/LFO, FL-style piano roll (stamp, scale, arp/strum, ghost patterns), Web MIDI + learn map
• Sampler — trim/reverse/loop/pitch, slice to pads, stems на пады
• AI Producer — preview → Apply/Reject; вкладка Room — presence, чат, локи
• Share — публичная страница /share/:token после Bounce/Rec
• Settings — FX/MIDI presets, electronic style packs; Pioneer-ish CC + channel:note map. Shift+click Play / Cue / PFL / hotcue / loop / key lock на деке — MIDI learn 1:1

Что уже сделано

• Реальный порядок инсертов на каждом mixer-канале: EQ3 / Filter / Comp / Drive / Crush / Flange / Delay / Reverb можно перетаскивать или двигать стрелками. Этот порядок применяется и live, и в browser-side Bounce; это встроенные Web Audio устройства, не VST/AU.
• MIDI с деки 1:1: hotcue, loop, PFL, Play, Cue и key lock привязываются по MIDI-каналу и ноте. Карта по умолчанию Pioneer-ish в стиле DDJ-400 (ch1 = Deck A, ch2 = Deck B), не официальный дамп контроллера.
• Наушники без permission dance: cue-окно играет ту же headphone-шину, не второй аудиодвижок. При поддержке браузера выбор выхода идёт через selectAudioOutput(); запасной список устройств не вызывает getUserMedia.

AI tools

analyze_audio, create_cue_point, create_loop, create_drum_pattern, create_synth_preset, suggest_transition, apply_mixer_settings, create_arrangement, apply_automation, export_mix, suggest_compatible_tracks, create_bassline, create_melody, create_chord_progression, separate_stems

Провайдер по умолчанию — mock. При AI_PROVIDER=openai и OPENAI_API_KEY используется OpenAI JSON tool-calling, иначе mock.

Тесты

cd backend
PYTHONPATH=..:. pytest -q

cd frontend
npm run build
npx playwright test

Ограничения

• Key lock — Rubber Band WASM (CDJ master tempo: pitch fader = tempo, key stays). WSOLA только если WASM не загрузился. rubberband-web — GPL-2.0.
• Stems — GPU Demucs (STEMS_DEVICE=auto → CUDA, затем MPS), иначе CPU Demucs, иначе HPSS. GPU/CPU Demucs: pip install -r backend/requirements-stems.txt и сборка torch. После Split stems глушат оригинал деки и играют vocals/drums/bass/other.
• Bounce — тот же граф, что в лайве: ChannelStrip + analog distortion/cabinet IR + plate/spring/tape convolution + flanger/delay/bitcrush/comp + sidechain + limiter. Не sample-identical с железом Pioneer.
• Rec HUD — таймер, peak, оценка размера; mic идёт в master и в Rec.
• MP3 анализируется через miniaudio (ffmpeg не нужен).
• Auth — JWT есть; в dev REQUIRE_AUTH=false оставляет demo-пользователя. SECRET_KEY пишется setup-скриптами.
• Upload до 250 MB, квота 2 GB на пользователя. HTTPS: X-Forwarded-Proto через ProxyHeadersMiddleware.

Подробный чеклист продукта: TODO.md. Что влито в main: CHANGELOG.md. Документация для разработки: docs/.