← 보드로 돌아가기

fspecii/ace-step-ui

🎵 The Ultimate Open Source Suno Alternative - Professional UI for ACE-Step 1.5 AI Music Generation. Free, local, unlimited. Stop paying for Suno!

GitHub에서 열기 ↗ ace-stepaiai-musiclocal-firstmusicmusic-generationopen-sourcereactsuno-alternativetypescript
4,316
GitHub 스타
656
포크
JavaScript
언어
미표기
라이선스
2026.06.27
최근 푸시
2026.04.30
별표한 날

AI 분석

설치 난이도: 보통
큐레이터 노트
로컬 AI 음악 생성에 관심이 있고, GPU 환경을 갖춘 개발자나 음악 제작자에게 적극 추천합니다. 상용 서비스의 대안으로 충분히 가치가 있습니다.

강점

  • 완전 무료이며 로컬에서 실행되어 프라이버시와 소유권을 보장합니다.
  • 스포티파이 스타일의 세련된 UI와 다양한 고급 기능(참조 오디오, 리페인팅, 시드 제어 등)을 제공합니다.
  • Pinokio를 통한 1-클릭 설치와 Windows Portable Package로 초보자도 쉽게 시작할 수 있습니다.

약점

  • NVIDIA GPU와 CUDA가 필요하여 GPU가 없는 사용자는 사용이 어렵습니다.
  • 모델 다운로드 용량이 약 5GB로 크고, 초기 설정이 다소 복잡할 수 있습니다.
  • ACE-Step 1.5 엔진에 의존적이므로 엔진 업데이트나 호환성 문제가 발생할 수 있습니다.

주의사항

  • LLM 기능(Thinking 모드)을 사용하려면 12GB 이상의 VRAM이 필요하며, 미만일 경우 자동 비활성화됩니다.
  • Windows Portable Package는 CUDA 12.8에 종속되므로 다른 버전과 충돌할 수 있습니다.
  • 로컬 실행이므로 컴퓨터 성능에 따라 생성 속도가 크게 달라질 수 있습니다.

시작 가이드

  • README의 설치 가이드를 따라 ACE-Step 1.5 엔진과 UI를 순서대로 설치합니다.
  • GPU 사양을 확인하고, 필요시 Windows Portable Package를 활용하여 간편하게 설치합니다.
  • 기본 설정으로 먼저 테스트 실행한 후, 필요에 따라 server/.env 파일을 수정합니다.

README 한국어 번역

이 번역은 AI가 원문 README를 옮긴 것입니다. 원문이 항상 우선합니다.

🎬 데모

<p align="center"> <a href="https://www.youtube.com/watch?v=8zg0Xi36qGc"> <img src="https://img.shields.io/badge/▶WatchFull_Demo-YouTube-FF0000?style=for-the-badge&logo=youtube" alt="Watch Demo on YouTube"> </a> </p>

<p align="center"> <img src="docs/demo.gif" alt="ACE-Step UI - Open Source Suno Alternative" width="100%"> </p>

<p align="center"> <em>스포티파이 스타일 인터페이스로 전문적인 AI 음악을 생성하세요 - 100% 무료, 로컬에서 실행</em> </p>

🚀 왜 ACE-Step UI인가?

Suno나 Udio에 매달 $10 이상 지불하는 데 지치셨나요? ACE-Step 1.5는 오픈소스 Suno 킬러로, 여러분의 GPU에서 로컬로 실행됩니다. 그리고 ACE-Step UI는 그 강력한 기능을 활용할 수 있는 아름답고 전문적인 인터페이스를 제공합니다.

기능 Suno/Udio ACE-Step UI
비용 $10-50/월 영원히 무료
프라이버시 클라우드 기반 100% 로컬
소유권 라이선스 모든 것을 소유
커스터마이징 제한적 완전한 제어
대기열 제한 제한됨 무제한
상업적 사용 비싼 요금제 제한 없음

ACE-Step 1.5의 특별한 점

  • 상용 서비스에 필적하는 최첨단 품질
  • 최대 4분 이상의 보컬이 포함된 전체 곡 생성
  • 로컬에서 실행 - 설정 후 인터넷 불필요
  • 오픈소스 - 검사, 수정, 개선 가능
  • 활발한 개발 - 지속적인 개선

✨ 기능

🎵 AI 음악 생성

기능 설명
전체 곡 생성 보컬과 가사가 포함된 최대 4분 이상의 완전한 곡 생성
악기 모드 보컬 없이 악기 트랙 생성
커스텀 모드 BPM, 조, 박자, 길이 세부 조정
스타일 태그 장르, 분위기, 템포, 악기 구성 정의
배치 생성 한 번에 여러 변형 생성
AI 향상 장르 태그를 적절한 BPM/조/박자가 포함된 상세 캡션으로 변환
Thinking 모드 AI가 구조를 추론하고 오디오 코드 생성

🎨 고급 파라미터

기능 설명
참조 오디오 모든 오디오 파일을 스타일 참조로 사용
오디오 커버 기존 오디오를 새로운 스타일로 변환
리페인팅 트랙의 특정 부분 재생성
시드 제어 정확한 생성을 재현하여 일관성 유지
추론 단계 품질과 속도 간의 균형 제어

🎤 가사 및 프롬프트

기능 설명
가사 편집기 구조 태그를 사용하여 가사 작성 및 포맷
포맷 도우미 AI 기반 캡션 및 가사 포맷팅
프롬프트 템플릿 장르 프리셋으로 빠른 시작
프롬프트 재사용 이전 생성에서 설정 복제

🎧 전문 인터페이스

기능 설명
스포티파이 스타일 UI 다크/라이트 모드를 지원하는 깔끔하고 현대적인 디자인
하단 플레이어 웨이브폼과 진행률을 갖춘 완전한 기능의 플레이어
라이브러리 관리 모든 트랙을 탐색, 검색, 정리
좋아요 및 재생목록 즐겨찾기를 사용자 정의 재생목록으로 정리
실시간 진행률 대기열 위치와 함께 실시간 생성 진행률 표시
LAN 접속 로컬 네트워크의 모든 기기에서 사용

🛠️ 내장 도구

기능 설명
오디오 편집기 AudioMass로 트림, 페이드, 효과 적용
스템 추출 Demucs로 보컬, 드럼, 베이스 등 분리
비디오 생성기 Pexels 배경으로 뮤직비디오 생성
그라디언트 커버 인터넷 없이 아름다운 절차적 앨범 아트 생성

💻 기술 스택

레이어 기술
프론트엔드 React 18, TypeScript, TailwindCSS, Vite
백엔드 Express.js, SQLite, better-sqlite3
AI 엔진 ACE-Step 1.5 (Gradio API)
오디오 도구 AudioMass, Demucs, FFmpeg

📋 요구 사항

요구 사항 사양
Node.js 18 이상
Python 3.10+ (3.11 권장) 또는 Windows Portable Package
NVIDIA GPU 4GB+ VRAM (LLM 없이 작동), 12GB+ 권장 (LLM 사용 시)
CUDA 12.8 (Windows Portable Package용)
FFmpeg 오디오 처리용
uv Python 패키지 관리자 (표준 설치 시 권장)

⚡ 빠른 시작

🎯 Pinokio - 1-Click 설치 (모든 사용자에게 권장!)

모든 플랫폼에서 ACE-Step UI를 실행하는 가장 쉬운 방법 — 터미널이나 수동 설정이 필요 없습니다:

<p align="center"> <a href="https://beta.pinokio.co/apps/github-com-cocktailpeanut-ace-step-ui-pinokio"> <img src="https://img.shields.io/badge/⚡InstallwithPinokio-OneClick-ff69b4?style=for-the-badge&labelColor=1a1a1a" alt="Install with Pinokio" height="50"> </a> </p>

Pinokio 가 Python, Node.js, 종속성, 모델 다운로드, 실행까지 모든 것을 자동으로 처리합니다. 설치를 클릭하고 음악을 만들기 시작하세요.

🪟 Windows - 원클릭 시작 (가장 쉬움!)

cd ace-step-ui
start-all.bat

끝입니다! 이 명령 하나로 API + 백엔드 + 프론트엔드가 모두 시작됩니다.

참고: 기본적으로 ACE-Step을 ..\ACE-Step-1.5에서 찾습니다.

다른 위치에 있는 경우 먼저 ACESTEP_PATH를 설정하세요:

```batch

set ACESTEP_PATH=C:\path\to\ACE-Step-1.5

start-all.bat

```

🪟 Windows - 수동 시작

REM 1. ACE-Step Gradio 시작 (API 엔드포인트 포함)
cd C:\ACE-Step-1.5
python_embeded\python -m acestep --port 8001 --enable-api --backend pt --server-name 127.0.0.1

REM 2. ACE-Step UI 시작 (다른 터미널에서)
cd ace-step-ui
start.bat

Linux / macOS - 원클릭 시작 (가장 쉬움!)

cd ace-step-ui./start-all.sh

끝입니다! 이 명령 하나로 Gradio + 백엔드 + 프론트엔드가 모두 시작됩니다.

참고: 기본적으로 ACE-Step을 ../ACE-Step-1.5에서 찾습니다.

다른 위치에 있는 경우 먼저 ACESTEP_PATH를 설정하세요:

```bash

export ACESTEP_PATH=/path/to/ACE-Step-1.5

>./start-all.sh

```

중지하려면: ./stop-all.sh

Linux / macOS - 수동 시작

# 1. ACE-Step Gradio를 API와 함께 시작 (ACE-Step-1.5 디렉토리에서)
cd /path/to/ACE-Step-1.5
uv run acestep --port 8001 --enable-api --backend pt --server-name 127.0.0.1

# 2. ACE-Step UI 시작 (다른 터미널에서)
cd ace-step-ui./start.sh

Windows (표준 설치)

REM 1. ACE-Step Gradio를 API와 함께 시작 (ACE-Step-1.5 디렉토리에서)
cd C:\path\to\ACE-Step-1.5
uv run acestep --port 8001 --enable-api --backend pt --server-name 127.0.0.1

REM 2. ACE-Step UI 시작 (다른 터미널에서)
cd ace-step-ui
start.bat

http://localhost:3000 을 열고 창작을 시작하세요!

📦 설치

1. ACE-Step 설치 (AI 엔진)

🪟 Windows Portable Package (Windows 권장)

Windows에서 가장 쉽게 시작하는 방법! 이 패키지에는 사전 구성된 모든 것이 포함되어 있습니다:

  1. ACE-Step-1.5.7z 다운로드 (~5GB)
  2. C:\ACE-Step-1.5에 압축 해제 (또는 원하는 위치)
  3. 완료! 패키지에는 모든 종속성이 포함된 python_embeded가 포함되어 있습니다.

✅ 4GB GPU에서 작동 - LLM 설치 불필요 ✅ CUDA 12.8 포함 ✅ 설정 번거로움 제로

참고: Thinking 모드(LLM 기능)는 VRAM이 12GB 미만인 GPU에서 자동으로 비활성화됩니다. 12GB 이상이면 수동으로 활성화할 수 있습니다.

표준 설치 (모든 플랫폼)

# ACE-Step 1.5 클론 - 오픈소스 Suno 대안
git clone https://github.com/ace-step/ACE-Step-1.5
cd ACE-Step-1.5

# 가상 환경 생성 및 설치
uv venv
uv pip install -e.

# 모델은 첫 실행 시 자동 다운로드 (~5GB)
cd..

2. ACE-Step UI 설치 (이 저장소)

Linux / macOS

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

# 설정 스크립트 실행 (모든 종속성 설치)./setup.sh

Windows

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

REM 설정 스크립트 실행 (모든 종속성 설치)
setup.bat

수동 설치 (모든 플랫폼)

# 프론트엔드 종속성 설치
npm install

# 서버 종속성 설치
cd server
npm install
cd..

# 환경 파일 복사
# Linux/macOS:
cp server/.env.example server/.env
# Windows:
copy server\.env.example server\.env

🎮 사용법

1단계: ACE-Step Gradio 서버 시작

🪟 Windows Portable Package:

cd C:\ACE-Step-1.5
python_embeded\python -m acestep --port 8001 --enable-api --backend pt --server-name 127.0.0.1

Linux / macOS:

cd /path/to/ACE-Step-1.5
uv run acestep --port 8001 --enable-api --backend pt --server-name 127.0.0.1

Windows (표준 설치):

cd C:\path\to\ACE-Step-1.5
uv run acestep --port 8001 --enable-api --backend pt --server-name 127.0.0.1

계속하기 전에 "API endpoints enabled" 메시지를 기다리세요.

2단계: ACE-Step UI 시작

Linux / macOS:

cd ace-step-ui./start.sh

Windows:

cd ace-step-ui
start.bat

3단계: 음악 만들기!

접속 URL
로컬 http://localhost:3000
LAN (다른 기기) http://YOUR_IP:3000

⚙️ 설정

server/.env 편집:

# 서버
PORT=3001

# ACE-Step Gradio URL (ACE-Step 시작 시 사용한 --port와 일치해야 함)
ACESTEP_API_URL=http://localhost:8001

# 데이터베이스 (로컬 우선, 클라우드 없음)
DATABASE_PATH=./data/acestep.db

# 선택 사항: 비디오 배경용 Pexels API
PEXELS_API_KEY=your_key_here

🎼 생성 모드

단순 모드

원하는 것을 설명하기만 하면 됩니다. ACE-Step이 나머지를 처리합니다.

"후렴구가 중독성 있는 여름 모험에 관한 경쾌한 팝송"

커스텀 모드

모든 파라미터를 완전히 제어:

파라미터 설명
가사 [Verse], [Chorus] 태그가 포함된 전체 가사
스타일 장르, 분위기, 악기, 템포
길이 30-240초
BPM 60-200

원본 저장소: fspecii/ace-step-ui

라이선스: 미표기

게재 제외를 원하시면 삭제 요청을 보내주세요.