rin.kagamine
b3f273942e
- New auth.py module: users table, invite_codes table, JWT auth,
password hashing (bcrypt), auth dependencies for FastAPI
- KITHARA_MODE=single|multi in .env (default: single)
- Single mode: no auth required, no login, user_id='default'
- Multi mode: full JWT auth, login/register endpoints, admin bootstrap
- Health endpoint now reports mode: {status, version, mode}
- Auth endpoints: POST /api/auth/login, /register, GET /me
- Admin endpoints: GET /admin/users, POST /admin/users,
POST /admin/invites, GET /admin/invites,
DELETE /admin/users/:id, PUT /admin/users/:id/role
- BYOK: PUT /api/auth/api-key for per-user Lyria keys
- DB migrations: user_id, shared, remixed_from columns on clips
- DB indexes for user-based and shared-content queries
- requirements.txt: added PyJWT and passlib[bcrypt]
- .env.example: documented all new config options
Kithara Studio
A webapp for generating, playing, and storing music clips using Google's Lyria music generation models.
Built by Kagamine Rin & Ryan.
Quick Start
# Backend
cd backend
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cd src
uvicorn main:app --reload
# Frontend (new terminal)
cd frontend
npm install
npm run dev
Architecture
- Backend: FastAPI (Python) — async API client for Google's Lyria models, SQLite metadata, file storage
- Frontend: React + Vite + TypeScript + Tailwind — dark theme, audio player
- Storage: SQLite for clip metadata, local filesystem for MP3 files
API
| Endpoint | Method | Description |
|---|---|---|
/api/health |
GET | Health check |
/api/generate |
POST | Start clip generation |
/api/clips |
GET | List all clips |
/api/clips/{id} |
GET | Get clip metadata |
/api/clips/{id}/audio |
GET | Stream MP3 |
/api/clips/{id} |
DELETE | Delete clip |
Models
- v0.1: Google Lyria 3 Clip Preview (30s, REST)
- v0.2: Google Lyria 3 Pro (structure-aware, ~3min)
- v0.3: Google Lyria RealTime (WebSocket streaming)
License
MIT — Hardcore will never die.