ACE-Step UI

The Ultimate Open Source Suno Alternative
Seamless integration with ACE-Step 1.5 - The Open Source AI Music Generation Model

Demo • Why ACE-Step • Features • Installation • Usage • Contributing

🎬 Demo

Generate professional AI music with a Spotify-like interface - 100% free and local

🚀 Why ACE-Step UI?

Tired of paying $10+/month for Suno or Udio? ACE-Step 1.5 is the open source Suno killer that runs locally on your own GPU - and ACE-Step UI gives you a beautiful, professional interface to harness its full power.

Feature	Suno/Udio	ACE-Step UI
Cost	$10-50/month	FREE forever
Privacy	Cloud-based	100% local
Ownership	Licensed	You own everything
Customization	Limited	Full control
Queue Limits	Restricted	Unlimited
Commercial Use	Expensive tiers	No restrictions

What Makes ACE-Step 1.5 Special?

State-of-the-art quality rivaling commercial services
Full song generation up to 4+ minutes with vocals
Runs locally - no internet required after setup
Open source - inspect, modify, improve
Active development - constant improvements

✨ Features

🎵 AI Music Generation

Feature	Description
Full Song Generation	Create complete songs with vocals and lyrics up to 4+ minutes
Instrumental Mode	Generate instrumental tracks without vocals
Custom Mode	Fine-tune BPM, key, time signature, and duration
Style Tags	Define genre, mood, tempo, and instrumentation
Batch Generation	Generate multiple variations at once
Thinking Mode	Let AI enhance your prompts automatically

🎨 Advanced Parameters

Feature	Description
Reference Audio	Use any audio file as a style reference
Audio Cover	Transform existing audio with new styles
Repainting	Regenerate specific sections of a track
Seed Control	Reproduce exact generations for consistency
Inference Steps	Control quality vs speed tradeoff

🎤 Lyrics & Prompts

Feature	Description
Lyrics Editor	Write and format lyrics with structure tags
Format Assistant	AI-powered caption and lyrics formatting
Prompt Templates	Quick-start with genre presets
Reuse Prompts	Clone settings from any previous generation

🎧 Professional Interface

Feature	Description
Spotify-Inspired UI	Clean, modern design with dark/light mode
Bottom Player	Full-featured player with waveform and progress
Library Management	Browse, search, and organize all your tracks
Likes & Playlists	Organize favorites into custom playlists
Real-time Progress	Live generation progress with queue position
LAN Access	Use from any device on your local network

🛠️ Built-in Tools

Feature	Description
Audio Editor	Trim, fade, and apply effects with AudioMass
Stem Extraction	Separate vocals, drums, bass, and other with Demucs
Video Generator	Create music videos with Pexels backgrounds
Gradient Covers	Beautiful procedural album art (no internet needed)

💻 Tech Stack

Layer	Technologies
Frontend	React 18, TypeScript, TailwindCSS, Vite
Backend	Express.js, SQLite, better-sqlite3
AI Engine	ACE-Step 1.5
Audio Tools	AudioMass, Demucs, FFmpeg

📋 Requirements

Requirement	Specification
Node.js	18 or higher
Python	3.10+ (3.11 recommended)
NVIDIA GPU	8GB+ VRAM (12GB+ recommended)
FFmpeg	For audio processing
uv	Python package manager (recommended)

⚡ Quick Start

Linux / macOS

# 1. Start ACE-Step API (in ACE-Step-1.5 directory)
cd /path/to/ACE-Step-1.5
uv run acestep-api --port 8001

# 2. Start ACE-Step UI (in another terminal)
cd ace-step-ui
./start.sh

Windows

REM 1. Start ACE-Step API (in ACE-Step-1.5 directory)
cd C:\path\to\ACE-Step-1.5
uv run acestep-api --port 8001

REM 2. Start ACE-Step UI (in another terminal)
cd ace-step-ui
start.bat

Open http://localhost:3000 and start creating!

📦 Installation

1. Install ACE-Step (The AI Engine)

# Clone ACE-Step 1.5 - the open source Suno alternative
git clone https://github.com/ace-step/ACE-Step-1.5
cd ACE-Step-1.5

# Create virtual environment and install
uv venv
uv pip install -e .

# Models download automatically on first run (~5GB)
cd ..

2. Install ACE-Step UI (This Repository)

Linux / macOS

# Clone the UI
git clone https://github.com/fspecii/ace-step-ui
cd ace-step-ui

# Run setup script (installs all dependencies)
./setup.sh

Windows

REM Clone the UI
git clone https://github.com/fspecii/ace-step-ui
cd ace-step-ui

REM Run setup script (installs all dependencies)
setup.bat

Manual Installation (All Platforms)

# Install frontend dependencies
npm install

# Install server dependencies
cd server
npm install
cd ..

# Copy environment file
# Linux/macOS:
cp server/.env.example server/.env
# Windows:
copy server\.env.example server\.env

🎮 Usage

Step 1: Start ACE-Step API Server

Linux / macOS:

cd /path/to/ACE-Step-1.5
uv run acestep-api --port 8001

Windows:

cd C:\path\to\ACE-Step-1.5
uv run acestep-api --port 8001

Wait for "Application startup complete" before proceeding.

Step 2: Start ACE-Step UI

Linux / macOS:

cd ace-step-ui
./start.sh

Windows:

cd ace-step-ui
start.bat

Step 3: Create Music!

Access	URL
Local	http://localhost:3000
LAN (other devices)	http://YOUR_IP:3000

⚙️ Configuration

Edit server/.env:

# Server
PORT=3001

# ACE-Step API (seamless integration)
ACESTEP_API_URL=http://localhost:8001

# Database (local-first, no cloud)
DATABASE_PATH=./data/acestep.db

# Optional: Pexels API for video backgrounds
PEXELS_API_KEY=your_key_here

🎼 Generation Modes

Simple Mode

Just describe what you want. ACE-Step handles the rest.

"An upbeat pop song about summer adventures with catchy hooks"

Custom Mode

Full control over every parameter:

Parameter	Description
Lyrics	Full lyrics with `[Verse]`, `[Chorus]` tags
Style	Genre, mood, instruments, tempo
Duration	30-240 seconds
BPM	60-200 beats per minute
Key	Musical key (C major, A minor, etc.)

🔧 Built-in Tools

Tool	Description
🎚️ Audio Editor	Cut, trim, fade, and apply effects
🎤 Stem Extraction	Separate vocals, drums, bass, other
🎬 Video Generator	Create music videos with stock footage
🎨 Album Art	Auto-generated gradient covers

🐛 Troubleshooting

Issue	Solution
ACE-Step API not reachable	Ensure `uv run acestep-api --port 8001` is running
CUDA out of memory	Close other GPU apps, reduce duration
Songs show 0:00 duration	Install FFmpeg: `sudo apt install ffmpeg`
LAN access not working	Check firewall allows ports 3000 and 3001

🤝 Contributing

We need your help to make ACE-Step UI even better!

This is a community-driven project and contributions are what make open source amazing. Whether you're fixing bugs, adding features, improving documentation, or sharing ideas - every contribution counts!

Ways to Contribute

🐛 Report bugs - Found an issue? Open a GitHub issue
💡 Suggest features - Have an idea? We'd love to hear it
🔧 Submit PRs - Code contributions are always welcome
📖 Improve docs - Help others get started
⭐ Star the repo - Show your support!

How to Contribute

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📣 Stay Connected

Subscribe and follow for:
🎥 Video tutorials and demos
🚀 New feature announcements
💡 Tips and tricks
🎵 AI music generation news

🙏 Credits

ACE-Step - The revolutionary open source AI music generation model
AudioMass - Web audio editor
Demucs - Audio source separation
Pexels - Stock video backgrounds

📄 License

This project is open source under the MIT License.

⭐ If ACE-Step UI helps you create amazing music, please star this repo! ⭐

Made with ❤️ for the open-source AI music community

Stop paying for Suno. Start creating with ACE-Step.

Name		Name	Last commit message	Last commit date
Latest commit History 12 Commits
audiomass-editor		audiomass-editor
components		components
context		context
docs		docs
server		server
services		services
.env.example		.env.example
.gitignore		.gitignore
App.tsx		App.tsx
README.md		README.md
global.d.ts		global.d.ts
index.html		index.html
index.tsx		index.tsx
metadata.json		metadata.json
package-lock.json		package-lock.json
package.json		package.json
setup.bat		setup.bat
setup.sh		setup.sh
start.bat		start.bat
start.sh		start.sh
tsconfig.json		tsconfig.json
types.ts		types.ts
vite.config.ts		vite.config.ts

Ladypoly/ace-step-ui

Folders and files

Latest commit

History

Repository files navigation

ACE-Step UI

🎬 Demo

🚀 Why ACE-Step UI?

What Makes ACE-Step 1.5 Special?

✨ Features

🎵 AI Music Generation

🎨 Advanced Parameters

🎤 Lyrics & Prompts

🎧 Professional Interface

🛠️ Built-in Tools

💻 Tech Stack

📋 Requirements

⚡ Quick Start

Linux / macOS

Windows

📦 Installation

1. Install ACE-Step (The AI Engine)

2. Install ACE-Step UI (This Repository)

Linux / macOS

Windows

Manual Installation (All Platforms)

🎮 Usage

Step 1: Start ACE-Step API Server

Step 2: Start ACE-Step UI

Step 3: Create Music!

⚙️ Configuration

🎼 Generation Modes

Simple Mode

Custom Mode

🔧 Built-in Tools

🐛 Troubleshooting

🤝 Contributing

Ways to Contribute

How to Contribute

📣 Stay Connected

🙏 Credits

📄 License

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages