How sruckh/minmaxmusic3-web works
MiniMax Music 3 Web is a self-hosted, multi-user music-generation console with optional YuE2 support. Users submit lyrics and style, optionally get an engine-specific AI draft, and queue a song; a background worker submits and polls inference jobs, stores audio and scores, and makes results available in song, history, and sharing views. YuE2 also supports score-based edits and recording covers from library items, uploads, or URLs. The graph reflects documented capabilities; some feature wiring is inferred only to the extent supported by the README and sampled files.
Main entry points: server.go HTTP server · worker.go Job worker · store.go Application store · handlers.go Song handlers
Components 20
Web and access
- Web interface
web/templates - HTTP server
internal/server/server.go - Authentication
internal/server/auth.go - Administration
internal/server/admin.go - Runtime configuration
internal/config/config.go
Song creation
- Song handlers
internal/server/handlers.go - Cover handling
internal/server/cover.go - Draft assistant
internal/llm/llm.go
Inference pipeline
- Job worker
internal/worker/worker.go - Inference client
internal/runpod/runpod.go - Audio transcoder
internal/audio/audio.go
Songs and accounts
- Application store
internal/store/store.go - Audio and score files
output - History views
web/templates/history.html - Song views
web/templates/song.html - Signed cover links
internal/server/cover.go
Other components
- User
- Chat service
- RunPod engines
- FFmpeg
Connections 27
- User → Web interface: uses
- Web interface → HTTP server: sends requests
- HTTP server → Authentication: authenticates
- HTTP server → Song handlers: dispatches
- HTTP server → Administration: dispatches
- Song handlers → Application store: queues jobs
- Song handlers → Draft assistant: requests drafts
- Draft assistant → Chat service: calls
- Song handlers → Cover handling: handles covers
- Cover handling → Application store: reads and writes
- Cover handling → Signed cover links: mints links
- Signed cover links → Application store: stores token hashes
- HTTP server → Job worker: runs workers
- Job worker → Application store: claims and updates jobs
- Job worker → Inference client: submits and polls
- Inference client → RunPod engines: calls
- Job worker → Audio transcoder: transcodes audio
- Audio transcoder → FFmpeg: invokes
- Job worker → Audio and score files: writes audio and scores
- Job worker → Application store: records songs
- Administration → Application store: manages accounts
- Authentication → Application store: reads and writes accounts
- HTTP server → History views: renders
- HTTP server → Song views: renders
- History views → User: shows songs
- Song views → User: shows results
- Runtime configuration → HTTP server: configures