Add Windows support: setup.bat and start.bat for Windows users

This commit is contained in:
fspecii
2026-02-04 03:20:03 +02:00
parent 256edbdf67
commit df3f91593a
3 changed files with 190 additions and 1 deletions
+41 -1
View File
@@ -147,6 +147,7 @@
## ⚡ Quick Start
### Linux / macOS
```bash
# 1. Start ACE-Step API (in ACE-Step directory)
cd /path/to/ACE-Step
@@ -157,6 +158,17 @@ cd ace-step-ui
./start.sh
```
### Windows
```batch
REM 1. Start ACE-Step API (in ACE-Step directory)
cd C:\path\to\ACE-Step
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!
---
@@ -180,6 +192,7 @@ cd ..
### 2. Install ACE-Step UI (This Repository)
#### Linux / macOS
```bash
# Clone the UI
git clone https://github.com/fspecii/ace-step-ui
@@ -189,7 +202,17 @@ cd ace-step-ui
./setup.sh
```
**Or install manually:**
#### Windows
```batch
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)
```bash
# Install frontend dependencies
@@ -201,7 +224,10 @@ npm install
cd ..
# Copy environment file
# Linux/macOS:
cp server/.env.example server/.env
# Windows:
copy server\.env.example server\.env
```
---
@@ -210,20 +236,34 @@ cp server/.env.example server/.env
### Step 1: Start ACE-Step API Server
**Linux / macOS:**
```bash
cd /path/to/ACE-Step
uv run acestep-api --port 8001
```
**Windows:**
```batch
cd C:\path\to\ACE-Step
uv run acestep-api --port 8001
```
Wait for "Application startup complete" before proceeding.
### Step 2: Start ACE-Step UI
**Linux / macOS:**
```bash
cd ace-step-ui
./start.sh
```
**Windows:**
```batch
cd ace-step-ui
start.bat
```
### Step 3: Create Music!
| Access | URL |
+73
View File
@@ -0,0 +1,73 @@
@echo off
REM ACE-Step UI Setup Script for Windows
setlocal enabledelayedexpansion
echo ==================================
echo ACE-Step UI Setup (Windows)
echo ==================================
echo.
REM Check Node.js
where node >nul 2>&1
if %ERRORLEVEL% NEQ 0 (
echo Error: Node.js not found!
echo Please install Node.js 18+ from https://nodejs.org/
pause
exit /b 1
)
REM Show Node version
for /f "tokens=*" %%i in ('node --version') do echo Node.js version: %%i
REM Install frontend dependencies
echo.
echo Installing frontend dependencies...
call npm install
if %ERRORLEVEL% NEQ 0 (
echo Error: Failed to install frontend dependencies
pause
exit /b 1
)
REM Install server dependencies
echo.
echo Installing server dependencies...
cd server
call npm install
if %ERRORLEVEL% NEQ 0 (
echo Error: Failed to install server dependencies
cd ..
pause
exit /b 1
)
cd ..
REM Create server .env if it doesn't exist
if not exist "server\.env" (
echo.
echo Creating server\.env from example...
copy server\.env.example server\.env
)
REM Create data directory
if not exist "server\data" (
mkdir server\data
)
echo.
echo ==================================
echo Setup Complete!
echo ==================================
echo.
echo Next steps:
echo.
echo 1. Start ACE-Step API (in ACE-Step folder):
echo cd path\to\ACE-Step
echo uv run acestep-api --port 8001
echo.
echo 2. Start ACE-Step UI:
echo start.bat
echo.
echo 3. Open http://localhost:3000
echo.
pause
+76
View File
@@ -0,0 +1,76 @@
@echo off
REM ACE-Step UI Startup Script for Windows
setlocal
echo ==================================
echo ACE-Step UI (Windows)
echo ==================================
echo.
REM Check if node_modules exists
if not exist "node_modules" (
echo Error: Dependencies not installed!
echo Please run setup.bat first.
pause
exit /b 1
)
if not exist "server\node_modules" (
echo Error: Server dependencies not installed!
echo Please run setup.bat first.
pause
exit /b 1
)
REM Get local IP for LAN access
for /f "tokens=2 delims=:" %%a in ('ipconfig ^| findstr /c:"IPv4"') do (
for /f "tokens=1" %%b in ("%%a") do (
set LOCAL_IP=%%b
)
)
echo Starting ACE-Step UI...
echo.
echo Make sure ACE-Step API is running:
echo cd path\to\ACE-Step
echo uv run acestep-api --port 8001
echo.
echo ==================================
echo.
REM Start backend in new window
echo Starting backend server...
start "ACE-Step UI Backend" cmd /k "cd server && npm run dev"
REM Wait for backend to start
echo Waiting for backend to start...
timeout /t 3 /nobreak >nul
REM Start frontend in new window
echo Starting frontend...
start "ACE-Step UI Frontend" cmd /k "npm run dev"
REM Wait a moment
timeout /t 2 /nobreak >nul
echo.
echo ==================================
echo ACE-Step UI Running!
echo ==================================
echo.
echo Frontend: http://localhost:3000
echo Backend: http://localhost:3001
echo.
if defined LOCAL_IP (
echo LAN Access: http://%LOCAL_IP%:3000
echo.
)
echo Close the terminal windows to stop.
echo.
echo ==================================
echo.
echo Opening browser...
timeout /t 2 /nobreak >nul
start http://localhost:3000
pause