- Home
- AI DJ Software
- DJClaw
DJClaw
What it is
DJClaw is an open-source framework for installing or developing an autonomous AI DJ Being on macOS or Linux. Its two-deck agent searches for music, downloads or generates tracks, plans sets, and mixes songs. Track choices use BPM compatibility, key matching, and energy flow, while transitions can use crossfade, bass swap, filter sweep, echo out, or hard cut. A background Planner prepares six tracks and loads them onto the idle deck. Gemini multimodal audio features analyze full tracks, inspect previews at selected positions, and perceive music during playback. Google Lyria 3 can generate original tracks with controls for BPM, key, mood, instruments, and style. After every five tracks, the Being updates its SOUL.md, MEMORY.md, and GOALS.md files. The terminal interface shows decks, meters, EQ, playlist, timeline, agent status, decisions, and countdown. The maker reports a run exceeding 30 hours across nine sets and 145-plus tracks, with $0.04 in total LLM cost.
For and against
For
- Open-source framework for autonomous DJ operation
- Automated mixing with five transition techniques
- AI track selection uses BPM, key, and energy
- Can generate tracks with Google Lyria 3
- Installers support macOS and Linux
Against
- Mixxx binary may require macOS Gatekeeper approval
- Requires Python 3.10 or newer for development
- Requires a LiteLLM-compatible API key
- Optional relay sends state to dj.treta.life
The verdict
DJClaw combines autonomous track planning, audio perception, mixing, and music generation in a desktop framework. Its installer and terminal interface target users comfortable setting up and developing an AI-driven DJ system.
Who it suits
DJClaw suits people who want to install or develop their own autonomous AI DJ Being. It is also intended for contributors working on Linux support, mixing, track selection, providers, frontends, or documentation.
On the record
- Audio perception
- Gemini multimodal audio features analyze full tracks, preview files at chosen positions, and perceive currently playing music in real time.github.com · read 7 Oct 2026
- Autonomous mixing
- Its two-deck DJ agent selects tracks using BPM compatibility, key matching, and energy flow, and can choose among five transition techniques.github.com · read 7 Oct 2026
- Autonomous operation
- The maker reports DJ Treta ran for 30+ hours across 9 sets, playing 145+ tracks, with a total LLM cost of $0.04.github.com · read 7 Oct 2026
- Installation
- The installer supports macOS arm64, macOS x64, and Linux x64, and installs the CLI and dependencies under the user’s home directory without sudo.github.com · read 7 Oct 2026
- Integrations
- The maker lists Google ADK, Gemini, Mixxx, Google Lyria 3, LiteLLM-compatible providers, and a separate MCP server for Claude Code integration.github.com · read 7 Oct 2026
- Intended audience
- The README presents DJClaw as a framework for people who want to install or develop their own AI DJ Being, and says contributions are welcome.github.com · read 7 Oct 2026
- Live streaming
- An optional WebSocket relay sends deck, perception, agent, and set state to dj.treta.life at 3Hz.github.com · read 7 Oct 2026
- Local installation
- The installer places files under the user's home directory without sudo and preserves configuration, music, and the database during upgrades.github.com · read 7 Oct 2026
- Mixing
- The DJ agent selects transition timing and among five techniques: crossfade, bass swap, filter sweep, echo out, and hard cut.github.com · read 7 Oct 2026
- Music generation
- The product can generate original tracks with Google Lyria 3, with controls for BPM, key, mood, instruments, and style.github.com · read 7 Oct 2026
- Notable limitation
- The README says the Mixxx binary is unsigned at v1 and may require the user to approve it through macOS Gatekeeper.github.com · read 7 Oct 2026
- Product
- DJClaw is an open-source framework for installing an autonomous AI DJ Being that searches, downloads, listens to, mixes, and generates music.github.com · read 7 Oct 2026
- Requirements
- Development prerequisites include Python 3.10+, the Mixxx fork on its treta branch, and a LiteLLM-compatible API key.github.com · read 7 Oct 2026
- Security detail
- The installer stores API keys in `secrets.env` with chmod 600 and keeps them under the user's config directory.github.com · read 7 Oct 2026
- Self-evolving identity
- After every five tracks, the Being updates its SOUL.md, MEMORY.md, and GOALS.md files.github.com · read 7 Oct 2026
- Support and contributions
- The maker welcomes contributions and identifies Linux support, transition techniques, track-selection heuristics, BPM detection, provider testing, frontend work, and documentation as areas needing help.github.com · read 7 Oct 2026
- Supported platforms
- The installer supports macOS arm64, macOS x64, and Linux x64.github.com · read 7 Oct 2026
- Terminal interface
- The `djclaw tui` terminal interface shows two decks, meters, EQ, playlist and track timeline, agent status, decisions, and transition countdown.github.com · read 7 Oct 2026
