hardbanrecords/Metadata-Engine

1# Music Metadata Engine2 3AI-Powered Audio Analysis & Metadata Enrichment Platform4 5## Quick Start6 71. **Clone the repository**82. **Install dependencies** (see below)93. **Configure environment variables** (backend/.env)104. **Run locally** or **deploy to Hugging Face Spaces**11 12---13 14## Local Development15 16### Backend17```bash18cd backend19python -m venv venv20.\venv\Scripts\activate  # Windows21pip install -r requirements.txt22uvicorn app.main:app --host 0.0.0.0 --port 888823```24 25### Frontend26```bash27cd frontend28npm install29npm run dev30```31 32Access at: http://localhost:517333 34---35 36## Deployment37 38For Hugging Face Spaces deployment, see: [HF_DEPLOYMENT_GUIDE.md](HF_DEPLOYMENT_GUIDE.md)39 40---41 42## Documentation43 44- **README.md** - This file (overview)45- **HF_DEPLOYMENT_GUIDE.md** - Step-by-step deployment instructions46- **FINAL_VERIFICATION_REPORT.md** - Full system verification & testing47- **UX_UI_DESIGN_SYSTEM.md** - Design tokens & component library48 49---50 51## License52 53MIT License - See LICENSE file54