Skip to content
SPECIFICTION
Get listed

DJClaw

github.com

macOSLinuxSelf-hosted
Visit github.com
Spec score 7.4 #13 of 17 in AI DJ Software

What it is

DJClaw is a free, 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, selects tracks using BPM compatibility, key matching, and energy flow, then chooses transition timing and one of five techniques: crossfade, bass swap, filter sweep, echo out, or hard cut. A background Planner prepares six tracks, downloading or generating them and loading them onto the idle deck. Gemini multimodal audio features analyze full tracks, inspect previews at selected positions, and perceive music while it plays. 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. Installers support macOS arm64, macOS x64, and Linux x64.

Spec sheet

Product
DJClaw is an open-source framework for installing an autonomous AI DJ Being that searches, downloads, listens to, mixes, and generates music.Read 7 Oct 2026 · github.com
Integrations
The maker lists Google ADK, Gemini, Mixxx, Google Lyria 3, LiteLLM-compatible providers, and a separate MCP server for Claude Code integration.Read 7 Oct 2026 · github.com
Audio perception
Gemini multimodal audio features analyze full tracks, preview files at chosen positions, and perceive currently playing music in real time.Read 7 Oct 2026 · github.com
Autonomous mixing
Its two-deck DJ agent selects tracks using BPM compatibility, key matching, and energy flow, and can choose among five transition techniques.Read 7 Oct 2026 · github.com
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.Read 7 Oct 2026 · github.com
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.Read 7 Oct 2026 · github.com
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.Read 7 Oct 2026 · github.com
Live streaming
An optional WebSocket relay sends deck, perception, agent, and set state to dj.treta.life at 3Hz.Read 7 Oct 2026 · github.com
Local installation
The installer places files under the user's home directory without sudo and preserves configuration, music, and the database during upgrades.Read 7 Oct 2026 · github.com
Mixing
The DJ agent selects transition timing and among five techniques: crossfade, bass swap, filter sweep, echo out, and hard cut.Read 7 Oct 2026 · github.com
Music generation
The product can generate original tracks with Google Lyria 3, with controls for BPM, key, mood, instruments, and style.Read 7 Oct 2026 · github.com
Notable limitation
The README says the Mixxx binary is unsigned at v1 and may require the user to approve it through macOS Gatekeeper.Read 7 Oct 2026 · github.com
Requirements
Development prerequisites include Python 3.10+, the Mixxx fork on its treta branch, and a LiteLLM-compatible API key.Read 7 Oct 2026 · github.com
Security detail
The installer stores API keys in `secrets.env` with chmod 600 and keeps them under the user's config directory.Read 7 Oct 2026 · github.com
Self-evolving identity
After every five tracks, the Being updates its SOUL.md, MEMORY.md, and GOALS.md files.Read 7 Oct 2026 · github.com
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.Read 7 Oct 2026 · github.com
Supported platforms
The installer supports macOS arm64, macOS x64, and Linux x64.Read 7 Oct 2026 · github.com
Terminal interface
The `djclaw tui` terminal interface shows two decks, meters, EQ, playlist and track timeline, agent status, decisions, and transition countdown.Read 7 Oct 2026 · github.com
Track planning
A background Planner agent plans six tracks, downloads or generates tracks, and loads them onto the idle deck.Read 7 Oct 2026 · github.com
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.Read 7 Oct 2026 · github.com
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.Read 7 Oct 2026 · github.com

Strong points and limits

Strong points

  • Free and open-source framework
  • Automated two-deck mixing
  • AI track selection uses BPM and key
  • Generates tracks with Google Lyria 3
  • Installers require no sudo

Limits

  • Mixxx binary may trigger macOS Gatekeeper
  • Requires a LiteLLM-compatible API key
  • Development requires Python 3.10+

Who it suits

It suits people who want to install or develop an autonomous AI DJ Being. It also fits contributors interested in Linux support, transition techniques, track selection, provider testing, frontend work, or documentation.

Verdict

DJClaw combines autonomous track planning, audio perception, mixing, and music generation in a self-hosted desktop framework. Its macOS and Linux installers simplify setup, while the unsigned Mixxx binary and API-key requirement affect installation.

Where Specifiction places it

Alternatives to DJClawAll alternatives →