1// Divinire.md
2// ---------------------------
3
4# Divinire
5
6Personal AI composer — learns your musical taste from Spotify, distills it into a 5-dimension Taste DNA, and generates original functional music that it then measures.
7
8**TYPE:** Full-Stack Application
9**STATUS:** In Development
10**DEV:** http://localhost:5200
11**WORKSPACE:** ~/GitHub/divinire
12**GITHUB:** nikanjuri/divinire (private)
13
14---
15
16## FEATURES
17
18- Spotify OAuth2 library ingestion with cursor-based sync builds a personal Taste DNA
19- 5-dimension taste vectorization from metadata only — BPM, key, energy, valence — never raw audio
20- Original generative synthesis via a pluggable provider layer (Replicate/MusicGen in production)
21- Per-mode personalization — thumb feedback nudges Focus/Sleep/Workout output
22- Evidence layer with in-session check-ins and preregistered A/B experiments
23- React web client with a user dashboard and an ops console; 78 backend tests passing
24
25---
26
27## TECHNOLOGIES
28
29- Python (FastAPI)
30- React + Vite
31- TypeScript
32- Replicate (MusicGen)
33- Spotify Web API
34- SQLAlchemy + Alembic
35
36---
37
38## NOTES
39
40Divinire generates original, royalty-free functional music (Focus / Sleep / Workout) tailored to your taste — then measures whether that music actually works for you.
41
42### Style synthesis, not audio processing
43
44The system analyzes your Spotify library as metadata — BPM, key, energy, valence — never the audio itself, and composes brand-new audio that matches your profile but is engineered for a specific function. No copyright risk, no derivative works.
45
46### A working system, not a blueprint
47
48The full pipeline runs end to end: Spotify ingestion → DNA vectorizer → sessions → generation queue with a pluggable provider layer → per-mode personalization → evidence and experimentation layer, plus a React web client with a user dashboard and ops console. 78 backend tests pass, and the schema is verified portable to Postgres/Supabase.
49
50### Evidence-based by design
51
52Rather than claiming the music "works", Divinire runs in-session experience-sampling check-ins and preregistered A/B experiments to validate its functional claims — the personalization loop learns from what measurably helps you focus, sleep, or train.