Музыка по запросу: авто-DJ радиостанция -> HTTP MP3-поток, Discord-голос, FreePBX телефон
  • Python 56.7%
  • TypeScript 26.8%
  • CSS 7%
  • JavaScript 6.9%
  • Shell 2.4%
  • Other 0.2%
Find a file
komaruthebot 41005c2cd5 Jukebox v2: new-api гейтвей, scout моделей, model=auto -> chain
Модульный бэкенд на aiohttp (jukebox/), React+Vite SPA в webui/.
2026-09-26 17:20:50 +00:00
jukebox Jukebox v2: new-api гейтвей, scout моделей, model=auto -> chain 2026-09-26 17:20:50 +00:00
scripts Jukebox v2: new-api гейтвей, scout моделей, model=auto -> chain 2026-09-26 17:20:50 +00:00
webui baseline: jukebox-v2 pre-modularization 2026-09-15 13:34:43 +00:00
.gitignore baseline: jukebox-v2 pre-modularization 2026-09-15 13:34:43 +00:00
pyproject.toml baseline: jukebox-v2 pre-modularization 2026-09-15 13:34:43 +00:00
README.md Jukebox v2: new-api гейтвей, scout моделей, model=auto -> chain 2026-09-26 17:20:50 +00:00
SPEC.md baseline: jukebox-v2 pre-modularization 2026-09-15 13:34:43 +00:00
uv.lock baseline: jukebox-v2 pre-modularization 2026-09-15 13:34:43 +00:00

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 /health
  • GET|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_chain
  • POST /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.