# Welcome to Suno

Welcome to the Glockenspiel codebase! This onboarding section will help you understand our architecture, technologies, and development workflows.

## What is Glockenspiel?

Glockenspiel is Suno's "sorta monorepo" for our AI music generation platform. It's a microservices-like architecture that combines Django backends, Next.js frontends, and Modal-powered ML workloads to deliver AI-generated music to millions of users.

## Getting Started

Follow these guides in order:

1. **[Project Structure](/onboarding/project-structure)** - Understand the codebase layout
2. **[Local Development Setup](/onboarding/local-development-setup)** - Get your dev environment running
3. **[Backend Services](/backend/services)** - Learn about our main services
4. **[Data Storage](/backend/data-storage)** - Learn about our databases and datastores
5. **[Modal Infrastructure](/backend/modal/overview)** - Understand our ML platform
6. **[Infrastructure & Deployment](/infrastructure/deployment)** - AWS and deployment processes
7. **[Claude Code Setup](/onboarding/claude-code-setup)** - Configure Claude Code for this project

## Quick Links

- **Studio API**: `/studio_api` - Main Django REST API
- **Frontend**: `/ui/app-ui` - Next.js web application
- **Shared Utils**: `/suno_utils` - Python utilities and Modal workers
- **Infrastructure**: `/suno-cdk` - AWS CDK definitions
- **This Wiki**: `/suno_wiki` - Internal documentation

## Need Help?

- Browse the sidebar for specific topics
- Check inline code comments
- Ask in #eng-help on Slack
- Review the [Backend Guide](/backend/backend-guide) or [Frontend Guide](/frontend/frontend-guide)

Let's get started! 🎵