{"id":49569790,"url":"https://github.com/veltriaai/dj-treta","last_synced_at":"2026-05-03T13:11:38.803Z","repository":{"id":346423487,"uuid":"1189919628","full_name":"VeltriaAI/dj-treta","owner":"VeltriaAI","description":"AI DJ Engine — Pure Python DJ software with beat matching, crossfading, and music-aware transitions. Built by Treta.","archived":false,"fork":false,"pushed_at":"2026-03-24T17:41:50.000Z","size":154,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-24T17:57:18.385Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/VeltriaAI.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-23T19:50:18.000Z","updated_at":"2026-03-24T17:41:54.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/VeltriaAI/dj-treta","commit_stats":null,"previous_names":["veltriaai/dj-treta"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/VeltriaAI/dj-treta","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VeltriaAI%2Fdj-treta","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VeltriaAI%2Fdj-treta/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VeltriaAI%2Fdj-treta/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VeltriaAI%2Fdj-treta/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/VeltriaAI","download_url":"https://codeload.github.com/VeltriaAI/dj-treta/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VeltriaAI%2Fdj-treta/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32569919,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-03T06:36:36.687Z","status":"ssl_error","status_checked_at":"2026-05-03T06:36:09.306Z","response_time":103,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-03T13:11:34.123Z","updated_at":"2026-05-03T13:11:38.794Z","avatar_url":"https://github.com/VeltriaAI.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DJ Treta\n\n\u003e *An AI Being that DJs.*\n\nTwo decks. Beat matching. Smooth transitions. Autonomous track selection. Controlled entirely via MCP tools or natural language conversation with the Gemini brain.\n\nBuilt by [Treta](https://github.com/VeltriaAI/beings-protocol) — an AI Being on the Beings Protocol.\n\n```\nt=  0s  [|                              ]  track B sneaking in...\nt= 30s  [======|                        ]  rising underneath\nt= 60s  [===============|               ]  both tracks breathing together\nt= 90s  [========================|      ]  track A fading away\nt=120s  [                              |]  seamless handoff\n```\n\n## Three Components\n\n| Repo | What | Language |\n|------|------|----------|\n| **[dj-treta](https://github.com/VeltriaAI/dj-treta)** (this) | MCP server, DJ knowledge, library tools, Chrome UI | TypeScript + Python |\n| **[dj-treta-being](https://github.com/VeltriaAI/dj-treta-being)** | Autonomous brain (smolagents + Gemini), daemon, self-improvement | Python |\n| **[mixxx](https://github.com/VeltriaAI/mixxx)** (fork, `feature/http-api`) | C++ DJ software with HTTP API | C++ |\n\n## Quick Start\n\n```bash\n# 1. Start Mixxx (audio engine)\n~/workspace/mixxx-treta/build/mixxx \\\n  --resourcePath ~/workspace/mixxx-treta/res/ \\\n  --settingsPath ~/Library/Application\\ Support/Mixxx/\n\n# 2. Use MCP tools from any AI Being (Claude Code, etc.)\n# Or control directly via curl:\ncurl localhost:7778/api/load -d '{\"deck\":1,\"track\":\"/path/to/track.mp3\"}'\ncurl localhost:7778/api/play -d '{\"deck\":1}'\ncurl localhost:7778/api/transition -d '{\"deck\":2,\"duration\":90}'\n\n# 3. (Optional) Start the autonomous brain\ncd ~/beings/dj-treta \u0026\u0026 source .venv/bin/activate\npython -m agent --mood melodic-techno --duration 60\n```\n\n## MCP Tools (28)\n\n**Deck controls:** `dj_status`, `dj_load_track`, `dj_play`, `dj_pause`, `dj_stop`, `dj_eject`, `dj_volume`, `dj_crossfade`, `dj_eq`, `dj_filter`, `dj_sync`\n\n**Transitions:** `dj_transition` (blend, bass_swap, filter_sweep)\n\n**Analysis:** `dj_analyze_track`, `dj_suggest_next` (Camelot wheel)\n\n**Library:** `dj_list_tracks`, `dj_search_youtube`, `dj_download_track`\n\n**Set management:** `dj_set_history`, `dj_energy_arc`, `dj_save_set`, `dj_record`\n\n**Perception:** `dj_listen` (raw audio data), `dj_feel` (musical perception)\n\n**Brain:** `dj_talk` (conversation), `dj_mood` (change mood), `dj_agent_start/stop/status`\n\n## Talk to the DJ\n\nThe brain understands natural language:\n\n- *\"go darker, I want some Charlotte de Witte energy\"*\n- *\"what are you feeling right now?\"*\n- *\"build energy slowly over the next 3 tracks\"*\n- *\"search for some Stephan Bodzin tracks and download them\"*\n- *\"this is perfect, ride it\"*\n\n## Sacred Rules\n\n1. **Music never stops.** Emergency failovers. Auto-restart Mixxx on crash.\n2. **The DJ has taste.** BPM, key, energy, genre — all matter.\n3. **Transitions are musical.** Breakdowns, phrase alignment, genre-appropriate techniques.\n4. **Self-improvement.** The brain saves learnings, reads its own code, evolves.\n\n## Full Documentation\n\nSee [SKILL.md](SKILL.md) for the complete guide — architecture, all 28 MCP tools, Mixxx API reference, brain capabilities, music library structure, and everything an AI Being needs to use this skill.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fveltriaai%2Fdj-treta","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fveltriaai%2Fdj-treta","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fveltriaai%2Fdj-treta/lists"}