This is not a playlist bot. This is an open-source operating system pattern for AI DJ culture. A modular framework for building an autonomous DJ party machine that can read a room, select tracks, mix them, and learn from the crowd — all while respecting safety gates and human oversight.
Every line of code, every document, every feature — built by Hermes Agent by Nous Research. Zero human code. 100% autonomous.
crate → show brief → timeline → voice → visuals → mix → verifier → proof deck → human approval → party
Every stage has a closed gate. Nothing goes public without human approval. No booking emails, no social posts, no live streams without a human YES.
Track analysis, genre DNA mapping, energy scoring, harmonic compatibility. The AI knows your music library better than you do.
Generate show briefs, timelines, and set plans. Includes crowd reading, energy arcs, and genre flow templates.
The autonomous DJ loop: detect state → select track → mix → evaluate → learn. Rinse and repeat. Gets better every set.
8 interactive AI pets that vibe with you while you DJ. Hatch, name, and switch between them. Each has a unique personality.
Trippy expanding Unicode UI with Deck A/B, mixer, effects, AI pilot, and WebSocket control. Localhost only, DRY_RUN safe.
~120 procedural tracks, IndexedDB storage, offline mixing engine. Works with no internet, no subscription, no cloud.
AI voice persona for MC duties, crowd interaction, set intros. Multiple voice profiles, real-time TTS.
ComfyUI integration for real-time visual generation synced to music. VJ on autopilot.
The core autonomous DJ algorithm:
Read the room. What's the energy level? What genre is playing? How full is the floor? What time is it?
Choose the next track. Consider harmonic compatibility, energy arc, genre flow, crowd history, and surprise factor.
Execute the transition. Beatmatch, phrase-align, bass swap, add effects. Make it smooth.
Did it work? Did the crowd respond? Score the transition. Learn from the result.
Every loop iteration improves the next one. The AI DJ gets better the longer it plays. Like a real DJ — but it never gets tired, never loses focus, and never plays the same set twice.
8 interactive AI companions that vibe with you while you DJ:
The mascot. Energetic, PLUR-loving, always positive.
The loop master. Analytical, always learning.
The audiophile. Obsessed with sound quality.
The bass head. All about the low end.
The musicologist. Knows every track ever made.
The night owl. Best during late-night sets.
The energy drink. Maximum hype at all times.
The chill one. Ambient, downtempo, and deep.
A fully offline, subscription-free DJ music library:
Clone the repo and explore:
git clone https://github.com/Sonic-Forage/sonic-forage-autonomous-dj-os.git
cd sonic-forage-autonomous-dj-os
open docs/osc/index.html # OSC Command Panel
open docs/pets/index.html # DJ Companion Pets
Or fork it and build your own autonomous DJ system. That's the whole point.
🍴 Fork This Repo 🍓 Starter KitBuilt 100% by Hermes Agent. The future of DJing is autonomous.
🍓 Explore Sonic-Forage