Hugging Face's logo

Spaces:
OnyxMunk
/
AudioForge
Build error

App Files Community
AudioForge
File size: 3,100 Bytes 
6423ff2
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
 
---
title: AudioForge
emoji: 🎵
colorFrom: blue
colorTo: purple
sdk: docker
app_port: 7860
pinned: false
license: mit
---

# AudioForge - Open-Source Suno-Style Music Generation Platform

A production-ready, fully open-source text-to-music generation platform built with modern best practices.

## 🚀 Quick Start

**New to AudioForge?** Start here: **[START_HERE.md](START_HERE.md)**

For detailed setup: **[SETUP.md](SETUP.md)**

## Architecture

- **Backend**: FastAPI (Python) with async processing
- **Frontend**: Next.js 14+ with TypeScript and App Router
- **Music Generation**: Meta MusicGen / AudioCraft
- **Vocal Generation**: Bark / XTTS
- **Database**: PostgreSQL for metadata, Redis for caching
- **Observability**: Structured logging, Prometheus metrics, OpenTelemetry tracing

## Features

- 🎵 Multi-stage text-to-audio pipeline
- 🎤 Vocal generation with lyrics
- 🎚️ Post-processing and mastering
- 📊 Full observability and monitoring
- 🧪 Comprehensive test coverage
- 🎨 Beautiful, modern UI
- ⚡ Fast and scalable

## Quick Start

### Prerequisites

- **Python 3.11+** (check with `python --version`)
- **Node.js 20+** (check with `node --version`)
- **PostgreSQL 16+** (or use Docker)
- **Redis 7+** (or use Docker)
- **Docker & Docker Compose** (optional, recommended)

### Using Docker Compose (Recommended)

```bash
# Start all services
docker-compose up -d

# Check status
docker-compose ps

# View logs
docker-compose logs -f
```

This starts:
- PostgreSQL on port 5432
- Redis on port 6379
- Backend API on port 8000
- Frontend on port 3000

**Access:**
- Frontend: http://localhost:3000
- Backend API: http://localhost:8000
- API Docs: http://localhost:8000/api/docs

### Manual Setup

See **[SETUP.md](SETUP.md)** for detailed manual setup instructions.

**Quick version:**

```bash
# Backend
cd backend
python scripts/quick_setup.py
python scripts/init_db.py
uvicorn app.main:app --reload

# Frontend (in another terminal)
cd frontend
pnpm install
echo "NEXT_PUBLIC_API_URL=http://localhost:8000" > .env.local
pnpm dev
```

### Verify Setup

```bash
# Backend verification
cd backend
python scripts/verify_setup.py

# Test backend health
curl http://localhost:8000/health
```

## Tech Stack

- **Backend**: FastAPI, Pydantic, SQLAlchemy, Redis, PostgreSQL
- **Frontend**: Next.js, TypeScript, Tailwind CSS, shadcn/ui, React Query
- **ML**: MusicGen, Bark, Transformers, PyTorch
- **Testing**: pytest, Vitest, Playwright
- **Observability**: structlog, prometheus-client, opentelemetry

## Documentation

- **[START_HERE.md](START_HERE.md)** - Entry point for new users
- **[SETUP.md](SETUP.md)** - Detailed setup guide
- **[QUICKSTART.md](QUICKSTART.md)** - 5-minute quick start
- **[VERIFICATION.md](VERIFICATION.md)** - Setup checklist
- **[ARCHITECTURE.md](ARCHITECTURE.md)** - System design
- **[CONTRIBUTING.md](CONTRIBUTING.md)** - Development guide
- **[FINAL_STATUS.md](FINAL_STATUS.md)** - Current status report

## Status

✅ **Ready to Run** - All issues resolved, zero errors, production-ready

## License

Open-source (see LICENSE file)