DOCUMENTATION / START HERE
GrooveNet is a self-hosted, multi-service project. The source repository is the canonical technical documentation and release record.
Read the project README ↗01
Development needs Docker with Compose v2, mise, just, and a Discogs account with a collection. Clone the main repository, install toolchains, configure the app environment, start the Compose stack, then run migrations.
git clone https://github.com/Public-Vinyl-Radio/groovenet
cd groovenet
mise install && just bootstrap
just compose-dev
just migrate-up02
Discogs credentials and PostgreSQL are foundational. Apple Music, YouTube, OpenAI embeddings and AI metadata, and remote backup are optional integrations configured through environment variables.
Environment configuration ↗03
The main application is Next.js and PostgreSQL with pgvector and Redis. Essentia analysis, genetic playlist generation, and downloads run as Python services. Typed API, CLI, and MCP packages sit alongside the application.
Project structure ↗04
The groovenet CLI supports searching, album and playlist management, playback, friend collections, and JSON output for scripting. The MCP server exposes collection operations to Claude Code.
PROJECT LINKS