0x1audio is a personal music catalog with ML indexing. Import your tracks, search by natural language or sound, and explore a similarity graph.

apps/frontend     React UI
apps/backend      API + ingest worker
apps/ml-worker    gRPC embeddings → Qdrant
proto/            shared protobuf

cp .env.example .env
docker compose -f compose.yaml -f compose.dev.yaml up --build

Requires NVIDIA Container Toolkit for the ML worker. Architecture: apps/ml-worker/README.md.

Contributing: CONTRIBUTING.md.

Roadmap

• MCP server
• Broader GPU / accelerator support
  • Integrated GPUs (Intel and similar)
  • AMD ROCm
  • Apple Silicon
• AWS hosting

Use cases

Home

Ask your library, jump into catalog / playlists / graph / jobs, and see what just finished indexing.

Graph

Pick a seed track and walk the sound-alike neighborhood — linked tracks, playback, and the similarity map.

Chat

Describe a vibe in natural language, get matching tracks, then create a playlist from the same conversation.