How joshuakosakowsky/ai-jukebox_mbax6418 works
AI Jukebox is a local browser app for creating, playing, and managing AI-generated songs with matching covers, plus optional spoken DJ introductions. The main workflow runs from the browser through the FastAPI app into session-scoped orchestration and class-service adapters; approved local samples provide a no-credentials playback path. The graph also includes lyrics, playback preferences, and voice references as distinct capabilities. Evidence is limited to the supplied excerpts and README; unsampled routes and frontend wiring are not asserted beyond documented behavior.
Main entry points: app.py FastAPI app · providers.py Provider adapters · sessions.py Session orchestration · app.js Jukebox interface
Components 15
Browser experience
- Jukebox interface
jukebox/web/app.js - Song ideas
jukebox/web/ideas.js - Appearance
jukebox/web/appearance.js
Application server
- FastAPI app
jukebox/app.py - Service settings
jukebox/config.py - App contracts
jukebox/contracts.py
Song generation
- Session orchestration
jukebox/sessions.py - Provider adapters
jukebox/providers.py
Playback and library
- Sample catalog
jukebox/samples.py - Session tracks and jobs
jukebox/sessions.py
Class services
- Text service
- Artwork service
- Music service
- Speech service
Other components
- Listener
Connections 22
- Listener → Jukebox interface: uses
README.md - Jukebox interface → Song ideas: requests ideas
README.md - Listener → Appearance: selects theme
README.md - Jukebox interface → FastAPI app: sends requests
- FastAPI app → Service settings: loads settings
jukebox/__main__.py - FastAPI app → Sample catalog: loads catalog
jukebox/app.py - FastAPI app → Session orchestration: routes session work
jukebox/app.py - FastAPI app → Provider adapters: initializes
jukebox/app.py - FastAPI app → App contracts: validates responses
jukebox/app.py - Session orchestration → Session tracks and jobs: updates
jukebox/sessions.py - Session orchestration → Provider adapters: requests generation
jukebox/sessions.py - Provider adapters → Service settings: uses credentials
jukebox/providers.py - Provider adapters → Text service: requests lyrics
README.md - Provider adapters → Artwork service: requests artwork
README.md - Provider adapters → Music service: submits and polls
jukebox/providers.py - Provider adapters → Speech service: requests speech
README.md - FastAPI app → Session tracks and jobs: serves media
jukebox/app.py - Sample catalog → Session tracks and jobs: seeds tracks
README.md - Listener → Jukebox interface: plays tracks
README.md - Jukebox interface → Session orchestration: requests DJ playback
- Session orchestration → Text service: writes introductions
jukebox/sessions.py - Session orchestration → Speech service: generates introductions
README.md