FREEDOM251

Freedom251 › AI DJ Software

DJClaw

Free plan LinuxMacSelf-hosted

Visit DJClaw Alternatives

DJClaw's own site

What DJClaw is

DJClaw is an open-source framework for installing or developing an autonomous AI DJ Being. Its two-deck agent selects music using BPM compatibility, key matching, and energy flow, then chooses when and how to transition between tracks. Available techniques are crossfade, bass swap, filter sweep, echo out, and hard cut. A background Planner prepares six tracks at a time, downloading or generating them and loading them onto the idle deck. Gemini multimodal audio features can analyze full tracks, inspect previews at chosen positions, and perceive music as it plays. DJClaw can also generate original tracks with Google Lyria 3, 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 `djclaw tui` terminal interface displays two decks, meters, EQ, playlist and timeline, agent status, decisions, and a transition countdown. The maker reports one run lasting more than 30 hours across nine sets and 145-plus tracks, with $0.04 in total LLM cost. DJClaw is free and open source, with installers for macOS arm64, macOS x64, and Linux x64.

Who it suits

DJClaw suits people who want to install or develop their own autonomous AI DJ Being. It may also interest contributors working on areas such as Linux support, transition techniques, track selection, BPM detection, or documentation.

What it does well

  • Open-source framework with free pricing.
  • Selects tracks using BPM, key, and energy flow.
  • Offers five automated transition techniques.
  • Can generate tracks with Google Lyria 3.
  • Installer supports macOS arm64, macOS x64, and Linux x64.

What to know first

  • Development requires Python 3.10+, a Mixxx fork, and an API key.
  • The Mixxx binary is unsigned at v1 and may need Gatekeeper approval on macOS.
  • The installer supports Linux x64, not other Linux architectures.

Getting started

  1. Open the DJClaw GitHub website.
  2. Use the installer for macOS arm64, macOS x64, or Linux x64.
  3. Prepare Python 3.10+, the Mixxx fork on its treta branch, and a LiteLLM-compatible API key.
  4. Run the CLI and open the `djclaw tui` terminal interface.

Verdict

Choose DJClaw if you want to install or develop an autonomous AI DJ that plans and mixes tracks. Its music generation and terminal interface add controls and visibility during operation. The listed prerequisites and possible macOS Gatekeeper approval may make setup less direct.

Questions

Is DJClaw free?

Yes. It is listed as free, with an open-source pricing note.

Which platforms does it support?

The installer supports macOS arm64, macOS x64, and Linux x64. The product is listed for Linux, macOS, and self-hosted use.

What does DJClaw integrate with?

The maker lists Google ADK, Gemini, Mixxx, Google Lyria 3, LiteLLM-compatible providers, and a separate MCP server for Claude Code integration.

What is needed to develop with DJClaw?

The listed development prerequisites are Python 3.10+, the Mixxx fork on its treta branch, and a LiteLLM-compatible API key.

Can DJClaw create original music?

Yes. It can generate original tracks with Google Lyria 3, with controls for BPM, key, mood, instruments, and style.

Does DJClaw require approval on macOS?

The maker says the Mixxx binary is unsigned at v1 and may require approval through macOS Gatekeeper.

Facts from DJClaw's own pages

Audio perception
Gemini multimodal audio features analyze full tracks, preview files at chosen positions, and perceive currently playing music in real time. · github.com, 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, 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, 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, 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, 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, 7 Oct 2026
Live streaming
An optional WebSocket relay sends deck, perception, agent, and set state to dj.treta.life at 3Hz. · github.com, 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, 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, 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, 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, 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, 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, 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, 7 Oct 2026
Self-evolving identity
After every five tracks, the Being updates its SOUL.md, MEMORY.md, and GOALS.md files. · github.com, 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, 7 Oct 2026
Supported platforms
The installer supports macOS arm64, macOS x64, and Linux x64. · github.com, 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, 7 Oct 2026
Track planning
A background Planner agent plans six tracks, downloads or generates tracks, and loads them onto the idle deck. · github.com, 7 Oct 2026
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. · github.com, 7 Oct 2026
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. · github.com, 7 Oct 2026

Where DJClaw stands on Freedom251

Look at these too