rin.kagamine
119b75fbcd
Backend:
- New endpoint: GET /api/clips/{id}/download
- Returns MP3 with Content-Disposition: attachment header
- Filename derived from clip title (sanitized) or prompt, falls back to clip ID
- Sanitization: alphanumeric + spaces/hyphens/underscores only, max 60 chars
- Uses FastAPI FileResponse with media_type=audio/mpeg
Frontend:
- Gallery ribbons: Download button (downward arrow icon) next to delete button
- Uses window.open() to trigger browser download
- Hover: lyria-accent color
- Gallery tiles: Download button in tile footer action row
- Small icon (w-3 h-3), same hover behavior
- DetailPanel: Full-width 'Download MP3' button above Delete Track
- lyria-accent styled, with download icon
- Uses <a href> with download attribute for native browser handling
Architecture KB updated with Export/Download section.
Lyria 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 Lyria API client, 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: Lyria 3 Clip Preview (30s, REST)
- v0.2: Lyria 3 Pro (structure-aware, ~3min)
- v0.3: Lyria RealTime (WebSocket streaming)
License
MIT — Hardcore will never die.