Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

DJClaw

github.com

  • Free plan
  • macOS
  • Linux
  • Self-hosted
7.1 Club score Visit github.com

What DJClaw 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, listens to tracks, plans sets, selects transitions and mixes songs. Track choices use BPM compatibility, key matching and energy flow, with crossfade, bass swap, filter sweep, echo out and hard cut available. A background Planner prepares six tracks, downloading or generating them and loading them onto the idle deck. Gemini multimodal audio can analyze full tracks, inspect previews at selected positions and perceive music in real time. Google Lyria 3 can generate original tracks with BPM, key, mood, instruments and style controls. After every five tracks, the Being updates its SOUL.md, MEMORY.md and GOALS.md files. The terminal interface shows two decks, meters, EQ, playlist, timeline, agent status and transition countdown. Installers support macOS arm64, macOS x64 and Linux x64 without sudo.

Who it suits

DJClaw suits people who want to install or develop their own autonomous AI DJ Being. The project also welcomes contributors to its listed development areas.

Good to know, and what to watch

  • Open-source framework with free pricing
  • Automates track selection and mixing
  • Generates music with configurable controls
  • Terminal interface shows decks and agent state
  • Installs under the user’s home directory
  • Requires Python 3.10 or newer
  • Needs a Mixxx fork on the treta branch
  • Requires a LiteLLM-compatible API key
  • Unsigned Mixxx binary may trigger macOS Gatekeeper

The verdict

DJClaw provides an autonomous DJ workflow with planning, perception, generation and mixing on supported desktop systems. It is most appropriate for technically minded users comfortable with local installation and development prerequisites.

What the maker publishes

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

Checked against the maker's pages on 7 Oct 2026.