Музыка по запросу: авто-DJ радиостанция -> HTTP MP3-поток, Discord-голос, FreePBX телефон
- Python 56.7%
- TypeScript 26.8%
- CSS 7%
- JavaScript 6.9%
- Shell 2.4%
- Other 0.2%
|
|
||
|---|---|---|
| jukebox | ||
| scripts | ||
| webui | ||
| .gitignore | ||
| pyproject.toml | ||
| README.md | ||
| SPEC.md | ||
| uv.lock | ||
Jukebox v2 — auto-DJ radio station
Опиши вайб → LLM-агент бесконечно подбирает конкретные треки с YouTube/SoundCloud,
качает их, нормализует громкость и склеивает в непрерывный MP3-поток. Поток отдаётся
по HTTP (браузер, любой плеер, m3u-плейлист).
Полный контракт поведения — в SPEC.md.
Что внутри
- Backend: Python 3.11+,
aiohttp(FastAPI-подобные хендлеры, без лишних зависимостей), FastAPI не используется. - Frontend: React + Vite SPA в
webui/(тёмная тема, мобильная вёрстка), сборка кладётся вwebui/distи отдаётся на/. - LLM-шлюз: new-api (
https://api.bird.komaruthecat.dedyn.io/v1), tool-calling. Скаут моделей —jukebox/scout.py. - Плагины:
jukebox/plugins/(phone-интеграция выключена по умолчанию).
Ноль хардкода: пути, хосты, порты, токены и модели резолвятся как
env → config.json в data-dir → default.
Запуск
uv run python -m jukebox --host 0.0.0.0 --port 8040
Dev-инстанс с изолированными данными:
JUKEBOX_DATA_DIR=/tmp/jb-smoke uv run python -m jukebox --port 18100 --host 0.0.0.0
Переменные окружения
| Переменная | Назначение |
|---|---|
JUKEBOX_API_KEY |
ключ new-api (обязателен) |
JUKEBOX_API_BASE |
база LLM-шлюза, дефолт https://api.bird.komaruthecat.dedyn.io/v1 |
JUKEBOX_TOKEN |
токен API; пустая строка = открытый режим |
JUKEBOX_DATA_DIR |
каталог состояния и логов |
JUKEBOX_YTDLP / JUKEBOX_FFMPEG / JUKEBOX_FFPROBE |
пути к бинарям |
Развёртывание
Живёт на Proxmox VM komaru@10.67.67.70, путь ~/jukebox-v2, порт 8040.
bash scripts/deploy-vm112.sh # rsync + venv/deps + env-файл + рестарт systemd + health
Разработка
python3 -m py_compile jukebox/*.py # быстрый синтаксис-чек
cd webui && npm run build # сборка дашборда
node scripts/smoke.mjs # ожидаем "SMOKE: ALL PASS"
Тесты (uv run pytest tests/) появятся позже — на момент коммита каталога tests/
ещё нет.
API (основное)
GET /healthGET|PUT /api/config— настройки (в т.ч.model_chain), применяются к живым станциямGET /api/stations,POST /api/stations,GET /api/stations/{sid}POST /api/stations/{sid}/stop|skip|retune|enqueue,DELETE /api/stations/{sid}GET /api/models— каталог иeffective_chainPOST /api/scout/run— прогнать скаут моделейGET /stream/{sid}— MP3-поток,GET /m3u/{sid}— плейлист (токен в query)GET /api/logs— персистентные логи станций (data/logs/*.jsonl)
Аутентификация: Authorization: Bearer <token>.
Где живёт
- Исходники:
~/jukebox-v2на komarupi (RPi5). - Живой инстанс: VM 112, сервис
jukebox-v2, порт 8040. - Репозиторий:
git.bird.komaruthecat.dedyn.io/komaruthebot/jukebox.