README.md

---
title: Songlab AI
emoji: 🎵
colorFrom: purple
colorTo: indigo
sdk: gradio
sdk_version: 6.0.0
app_file: app_gradio.py
pinned: false
license: unknown
---

# SongLab AI - Music Generation Platform

Professional music generation platform with WordPress integration for authentication and credits.

## Features

- 🎵 Unlimited music generation (no limits!)
- 🎤 Vocals and lyrics support
- 🎚️ Professional audio effects
- 💳 Credit-based download system
- 🔐 WordPress SSO authentication
- ⚡ Gradio-powered modern UI

## Setup

### Environment Variables

Required environment variables for deployment:

```bash
LYRICS_API_URL=<Your lyrics generation API endpoint>
BEARER_TOKEN=<Your API bearer token>
```

### WordPress Integration

The app expects JWT token authentication via URL parameters:

```
https://your-space.hf.space?jwt_token=<TOKEN>&user_id=<USER_ID>
```

WordPress should send these parameters when embedding the Space.

## Local Development

```bash
pip install -r requirements.txt
python app_gradio.py
```

## WordPress Plugin

A companion WordPress plugin is available to embed this Space seamlessly with automatic authentication.

Install the `songlab-ai-embed` plugin and use the shortcode:

```
[songlab_ai_app]
```

## Credits System

- **Generation**: Unlimited and free for all users
- **Downloads**:
  - Tier 1: 10-second downloads (requires 1 Tier 1 credit)
  - Tier 2: 20-second downloads (requires 1 Tier 2 credit)

Credits are managed via WordPress and deducted upon download.