DJClaw
DJClaw is an open-source framework for installing or developing an autonomous AI DJ Being on macOS or Linux.
What DJClaw 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 and downloads music, evaluates tracks, plans sets, and chooses transitions using BPM compatibility, key matching, and energy flow. Available techniques are crossfade, bass swap, filter sweep, echo out, and hard cut. A background Planner prepares six tracks, downloading or generating them and loading them onto the idle deck. Gemini audio features can analyze full tracks, inspect previews, and perceive music during playback. Original tracks can be generated with Google Lyria 3 using BPM, key, mood, instruments, and style controls. The terminal interface displays decks, meters, EQ, playlists, timelines, agent status, decisions, and countdowns. After every five tracks, identity files are updated. Installers support macOS arm64, macOS x64, and Linux x64 without sudo.
Good
- Open-source framework for autonomous DJ operation
- Supports macOS and Linux installers
- Uses five selectable transition techniques
- Can generate tracks with Google Lyria 3
- Includes a two-deck terminal interface
Watch out
- Requires Python 3.10 or newer
- Needs a LiteLLM-compatible API key
- Mixxx binary may require Gatekeeper approval
- Development uses a Mixxx fork
Who it suits
DJClaw suits people who want to install or develop an autonomous AI DJ Being. It also welcomes contributors working on mixing, selection, integrations, documentation, and related areas.
Verdict
DJClaw combines automated track selection, mixing, perception, and music generation in an open framework. Its setup requirements and unsigned Mixxx binary matter for installation.
The facts
Each one read from DJClaw's own pages, with the date it was checked.
What it does
- Audio perception
- Gemini multimodal audio features analyze full tracks, preview files at chosen positions, and perceive currently playing music in real time.checked 7 Oct 2001
- Autonomous mixing
- Its two-deck DJ agent selects tracks using BPM compatibility, key matching, and energy flow, and can choose among five transition techniques.checked 7 Oct 2001
- 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.checked 7 Oct 2001
- 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.checked 7 Oct 2001
- Integrations
- The maker lists Google ADK, Gemini, Mixxx, Google Lyria 3, LiteLLM-compatible providers, and a separate MCP server for Claude Code integration.checked 7 Oct 2001
- 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.checked 7 Oct 2001
- Live streaming
- An optional WebSocket relay sends deck, perception, agent, and set state to dj.treta.life at 3Hz.checked 7 Oct 2001
- Local installation
- The installer places files under the user's home directory without sudo and preserves configuration, music, and the database during upgrades.checked 7 Oct 2001
- Mixing
- The DJ agent selects transition timing and among five techniques: crossfade, bass swap, filter sweep, echo out, and hard cut.checked 7 Oct 2001
- Music generation
- The product can generate original tracks with Google Lyria 3, with controls for BPM, key, mood, instruments, and style.checked 7 Oct 2001
- Notable limitation
- The README says the Mixxx binary is unsigned at v1 and may require the user to approve it through macOS Gatekeeper.checked 7 Oct 2001
- Product
- DJClaw is an open-source framework for installing an autonomous AI DJ Being that searches, downloads, listens to, mixes, and generates music.checked 7 Oct 2001
- Requirements
- Development prerequisites include Python 3.10+, the Mixxx fork on its treta branch, and a LiteLLM-compatible API key.checked 7 Oct 2001
- Security detail
- The installer stores API keys in `secrets.env` with chmod 600 and keeps them under the user's config directory.checked 7 Oct 2001
- Self-evolving identity
- After every five tracks, the Being updates its SOUL.md, MEMORY.md, and GOALS.md files.checked 7 Oct 2001
- 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.checked 7 Oct 2001
- Terminal interface
- The `djclaw tui` terminal interface shows two decks, meters, EQ, playlist and track timeline, agent status, decisions, and transition countdown.checked 7 Oct 2001
- Who it is for
- The maker describes DJClaw as an open-source framework for people who want to install or develop their own autonomous AI DJ Being.checked 7 Oct 2001
Where it runs
- Supported platforms
- The installer supports macOS arm64, macOS x64, and Linux x64.checked 7 Oct 2001
Money
- Track planning
- A background Planner agent plans six tracks, downloads or generates tracks, and loads them onto the idle deck.checked 7 Oct 2001
- Usage cost example
- The project reports that DJ Treta ran for 30+ hours with a total LLM cost of $0.04 in its first autonomous run.checked 7 Oct 2001
Alternatives to DJClaw
- 1
djay
Free planAndroidiOSmacOSWindows8.1From $4.17 a month - 2
CortexDJ
Free planWebAPImacOSWindows7.6From $4.92 a month - 3
CRATELAB
Free planWebLinuxmacOSWindows7.6From $9.99 a month - 4
NeonDeck
Free planWeb7.2From €4.99 a month - 5
Offtrack
Free planAndroidiOSmacOS7.1From $3.33 a month - 6
MIXX Intelligence
Free planmacOS6.6From $7.99 a month