diff --git a/README.md b/README.md index 15a8cf3..317806c 100644 --- a/README.md +++ b/README.md @@ -154,6 +154,20 @@ ## ⚡ Quick Start +### 🎯 Pinokio - 1-Click Install (Recommended for All Users!) + +The easiest way to get ACE-Step UI up and running on **any platform** — no terminal, no manual setup: + +

+ + Install with Pinokio + +

+ +> **[Pinokio](https://pinokio.computer)** handles everything automatically: Python, Node.js, dependencies, model downloads, and launching. Just click install and start making music. + +--- + ### 🪟 Windows - One-Click Start (Easiest!) ```batch cd ace-step-ui @@ -380,6 +394,16 @@ Full control over every parameter: | **BPM** | 60-200 beats per minute | | **Key** | Musical key (C major, A minor, etc.) | +### Batch Size & Bulk Generation + +| Setting | Description | +|---------|-------------| +| **Batch Size** | Number of variations generated per job (1-4). Default is **1** for broad GPU compatibility. Higher values generate more variations but use more VRAM. **8GB GPU users should keep this at 1.** | +| **Bulk Generate** | Queue multiple independent generation jobs (1-10). Each job runs sequentially, so this is safe for any GPU. | +| **LM Backend** | Choose between **PT** (~1.6 GB VRAM) and **VLLM** (~9.2 GB VRAM). PT is the default and works on most GPUs. | + +> **Tip:** Both batch size and bulk count are remembered in your browser — set them once and they stick for future sessions. + --- ## 🔧 Built-in Tools @@ -398,8 +422,8 @@ Full control over every parameter: | Issue | Solution | |-------|----------| | **ACE-Step API not reachable** | Ensure API server is running (see Usage section) | -| **CUDA out of memory** | Close other GPU apps, reduce duration, or disable Thinking Mode | -| **4GB GPU - Out of memory** | Make sure **Thinking Mode is OFF** (it's off by default). LLM features require 12GB+ | +| **CUDA out of memory** | Switch LM Backend to **PT**, set batch size to **1**, reduce duration, or disable Thinking Mode | +| **4GB GPU - Out of memory** | Use **PT** backend (default), batch size **1**, and keep **Thinking Mode OFF**. LLM features require 12GB+ | | **AttributeError: 'NoneType'** | Update to latest ACE-Step-1.5 (fix merged in PR #109) | | **Songs show 0:00 duration** | Install FFmpeg: `sudo apt install ffmpeg` (Linux) or download from [ffmpeg.org](https://ffmpeg.org) (Windows) | | **LAN access not working** | Check firewall allows ports 3000 and 3001 | diff --git a/components/CreatePanel.tsx b/components/CreatePanel.tsx index c54fb94..b61041e 100644 --- a/components/CreatePanel.tsx +++ b/components/CreatePanel.tsx @@ -135,8 +135,14 @@ export const CreatePanel: React.FC = ({ // Advanced Settings const [showAdvanced, setShowAdvanced] = useState(false); const [duration, setDuration] = useState(-1); - const [batchSize, setBatchSize] = useState(2); - const [bulkCount, setBulkCount] = useState(1); // Number of independent generation jobs to queue + const [batchSize, setBatchSize] = useState(() => { + const stored = localStorage.getItem('ace-batchSize'); + return stored ? Number(stored) : 1; + }); + const [bulkCount, setBulkCount] = useState(() => { + const stored = localStorage.getItem('ace-bulkCount'); + return stored ? Number(stored) : 1; + }); const [guidanceScale, setGuidanceScale] = useState(9.0); const [randomSeed, setRandomSeed] = useState(true); const [seed, setSeed] = useState(-1); @@ -1028,7 +1034,7 @@ export const CreatePanel: React.FC = ({ max="4" step="1" value={batchSize} - onChange={(e) => setBatchSize(Number(e.target.value))} + onChange={(e) => { const v = Number(e.target.value); setBatchSize(v); localStorage.setItem('ace-batchSize', String(v)); }} className="w-full h-2 bg-zinc-200 dark:bg-zinc-700 rounded-lg appearance-none cursor-pointer accent-pink-500" />

Number of song variations to generate

@@ -1494,7 +1500,7 @@ export const CreatePanel: React.FC = ({ max="4" step="1" value={batchSize} - onChange={(e) => setBatchSize(Number(e.target.value))} + onChange={(e) => { const v = Number(e.target.value); setBatchSize(v); localStorage.setItem('ace-batchSize', String(v)); }} className="w-full h-2 bg-zinc-200 dark:bg-zinc-700 rounded-lg appearance-none cursor-pointer accent-pink-500" />

How many versions to create in one run

@@ -1512,7 +1518,7 @@ export const CreatePanel: React.FC = ({ {[1, 2, 3, 5, 10].map((count) => (