Merge pull request #23 from audiohacking/update-bins

Update bins

Author: lmangani

.env.example

@@ -28,8 +28,8 @@ MODELS_DIR=./models
 #   No need to set anything below if you used ./build.sh.
 #
 # Override individual binary paths only if they live outside ./bin/:
-# ACE_QWEN3_BIN=/path/to/ace-qwen3
-# DIT_VAE_BIN=/path/to/dit-vae
+# ACE_LM_BIN=/path/to/ace-lm
+# ACE_SYNTH_BIN=/path/to/ace-synth
 # ACE_UNDERSTAND_BIN=/path/to/ace-understand
 #
 # Override the primary DiT GGUF only if you want a non-default model:
@@ -70,10 +70,10 @@ JWT_SECRET=ace-step-ui-local-secret
 # PEXELS_API_KEY=
 
 # ── Binary extra arguments ────────────────────────────────────────────────────
-# Append extra CLI flags to the ace-qwen3 or dit-vae spawn invocations.
+# Append extra CLI flags to the ace-lm or ace-synth spawn invocations.
 # Useful for hardware-specific tuning or debugging, e.g. limit CPU threads:
-#   ACE_QWEN3_EXTRA_ARGS=--threads 4
-#   DIT_VAE_EXTRA_ARGS=--threads 4
+#   ACE_LM_EXTRA_ARGS=--threads 4
+#   ACE_SYNTH_EXTRA_ARGS=--threads 4
 #
-# DIT_VAE_EXTRA_ARGS=
-# ACE_QWEN3_EXTRA_ARGS=
+# ACE_SYNTH_EXTRA_ARGS=
+# ACE_LM_EXTRA_ARGS=

.github/workflows/ci.yml

@@ -131,7 +131,7 @@ jobs:
         shell: bash
         run: |
           ALL_OK=1
-          for bin in ace-qwen3 dit-vae neural-codec; do
+          for bin in ace-lm ace-synth neural-codec; do
             if [ -x "bin/$bin" ]; then
               echo "✅ bin/$bin"
             else

.github/workflows/electron-release.yml

@@ -7,11 +7,11 @@ on:
   workflow_dispatch:
     inputs:
       tag:
-        description: "Release tag (e.g. v0.0.1)"
+        description: "Release tag (e.g. v0.0.2)"
         required: true
-        default: "v0.0.1"
+        default: "v0.0.2"
       binary_version:
-        description: "acestep.cpp release tag to bundle (e.g. v0.0.1)"
+        description: "acestep.cpp release tag to bundle (e.g. v0.0.2)"
         required: false
         default: "v0.0.2"
 
@@ -22,15 +22,15 @@ concurrency:
 env:
   NODE_VERSION: "20"
   # acestep.cpp binary release to bundle; override via workflow_dispatch input.
-  BINARY_VERSION: ${{ github.event.inputs.binary_version || 'v0.0.1' }}
+  BINARY_VERSION: ${{ github.event.inputs.binary_version || 'v0.0.2' }}
 
 # ──────────────────────────────────────────────────────────────────────────────
 # Shared setup steps are defined as a reusable composite action inline via
 # `run` steps repeated in each job.  Each job is self-contained so the CI
 # log is easy to read and debug per platform.
 #
 # Archive layout (flat tarball — all files at ./):
-#   bin/<binary>          ace-qwen3, dit-vae, neural-codec, …
+#   bin/<binary>          ace-lm, ace-synth, neural-codec, …
 #   bin/lib<name>.so      Linux shared libraries (unversioned names)
 #   bin/lib<name>.dylib   macOS dylibs (versioned + symlink chain)
 # ──────────────────────────────────────────────────────────────────────────────
@@ -93,7 +93,7 @@ jobs:
               else echo "⚠️  bin/${name} — missing"; warn=1; fi
             done
           done
-          for bin in ace-qwen3 dit-vae neural-codec; do
+          for bin in ace-lm ace-synth neural-codec; do
             if [ -f "bin/${bin}" ] && [ -x "bin/${bin}" ]; then echo "✅  bin/${bin}"
             else echo "⚠️  bin/${bin} — not found or not executable"; warn=1; fi
           done
@@ -104,7 +104,7 @@ jobs:
         shell: bash
         run: |
           TAG="${GITHUB_REF_NAME:-}"
-          [[ "$TAG" == v* ]] || TAG="${{ github.event.inputs.tag || 'v0.0.1-electron' }}"
+          [[ "$TAG" == v* ]] || TAG="${{ github.event.inputs.tag || 'v0.0.2-electron' }}"
           echo "tag=$TAG" >> "$GITHUB_OUTPUT"
           
       - name: Rebuild native modules for Electron
@@ -237,7 +237,7 @@ jobs:
         shell: bash
         run: |
           warn=0
-          for bin in ace-qwen3 dit-vae neural-codec; do
+          for bin in ace-lm ace-synth neural-codec; do
             if [ -f "bin/${bin}" ] && [ -x "bin/${bin}" ]; then echo "✅  bin/${bin}"
             else echo "⚠️  bin/${bin} — not found or not executable"; warn=1; fi
           done
@@ -258,7 +258,7 @@ jobs:
         shell: bash
         run: |
           TAG="${GITHUB_REF_NAME:-}"
-          [[ "$TAG" == v* ]] || TAG="${{ github.event.inputs.tag || 'v0.0.1-electron' }}"
+          [[ "$TAG" == v* ]] || TAG="${{ github.event.inputs.tag || 'v0.0.2-electron' }}"
           echo "tag=$TAG" >> "$GITHUB_OUTPUT"
 
       - name: Build Electron package (Linux)
@@ -306,7 +306,7 @@ jobs:
         shell: bash
         run: |
           TAG="${GITHUB_REF_NAME:-}"
-          [[ "$TAG" == v* ]] || TAG="${{ github.event.inputs.tag || 'v0.0.1-electron' }}"
+          [[ "$TAG" == v* ]] || TAG="${{ github.event.inputs.tag || 'v0.0.2-electron' }}"
           echo "tag=$TAG" >> "$GITHUB_OUTPUT"
 
       - name: Check if Release Exists

.github/workflows/release.yml

@@ -154,7 +154,7 @@ jobs:
           [ -f .env ] && export $(grep -v '^#' .env | grep -v '^\s*$' | xargs)
           
           # ── First-run: compile acestep.cpp ───────────────────────────────────────────
-          if [ ! -x "$DIR/bin/ace-qwen3" ] || [ ! -x "$DIR/bin/dit-vae" ]; then
+          if [ ! -x "$DIR/bin/ace-lm" ] || [ ! -x "$DIR/bin/ace-synth" ]; then
             echo "═══════════════════════════════════════════════════════"
             echo "  First run: building acestep.cpp for your hardware"
             echo "  GPU support (CUDA / ROCm / Vulkan / Metal) is"
@@ -180,15 +180,15 @@ jobs:
           fi
           
           # ── Start the server ─────────────────────────────────────────────────────────
-          : "${ACE_QWEN3_BIN:=$DIR/bin/ace-qwen3}"
-          : "${DIT_VAE_BIN:=$DIR/bin/dit-vae}"
+          : "${ACE_LM_BIN:=$DIR/bin/ace-lm}"
+          : "${ACE_SYNTH_BIN:=$DIR/bin/ace-synth}"
           : "${PORT:=3001}"
           
           mkdir -p logs data public/audio
           
           echo "Starting ACE-Step UI on port $PORT ..."
-          ACE_QWEN3_BIN="$ACE_QWEN3_BIN" \
-          DIT_VAE_BIN="$DIT_VAE_BIN" \
+          ACE_LM_BIN="$ACE_LM_BIN" \
+          ACE_SYNTH_BIN="$ACE_SYNTH_BIN" \
           MODELS_DIR="$MODELS_DIR" \
           PORT="$PORT" \
           DATABASE_PATH="$DIR/data/acestep.db" \
@@ -224,7 +224,7 @@ jobs:
           )
           
           :: First-run: compile acestep.cpp
-          if not exist "%DIR%bin\ace-qwen3.exe" (
+          if not exist "%DIR%bin\ace-lm.exe" (
               echo ═══════════════════════════════════════════════════════
               echo   First run: building acestep.cpp for your hardware
               echo   GPU support ^(CUDA / Vulkan^) is detected automatically.
@@ -250,8 +250,8 @@ jobs:
           )
           
           :: Start the server
-          if "%ACE_QWEN3_BIN%"=="" set ACE_QWEN3_BIN=%DIR%bin\ace-qwen3.exe
-          if "%DIT_VAE_BIN%"==""   set DIT_VAE_BIN=%DIR%bin\dit-vae.exe
+          if "%ACE_LM_BIN%"=="" set ACE_LM_BIN=%DIR%bin\ace-lm.exe
+          if "%ACE_SYNTH_BIN%"==""   set ACE_SYNTH_BIN=%DIR%bin\ace-synth.exe
           if "%PORT%"==""           set PORT=3001
           mkdir logs 2>nul & mkdir data 2>nul & mkdir public\audio 2>nul
           
@@ -315,8 +315,8 @@ jobs:
           
           | Variable | Default | Description |
           |----------|---------|-------------|
-          | `ACE_QWEN3_BIN` | `./bin/ace-qwen3` | Path to the ace-qwen3 LLM binary |
-          | `DIT_VAE_BIN` | `./bin/dit-vae` | Path to the dit-vae binary |
+          | `ACE_LM_BIN` | `./bin/ace-lm` | Path to the ace-lm LLM binary |
+          | `ACE_SYNTH_BIN` | `./bin/ace-synth` | Path to the ace-synth binary |
           | `MODELS_DIR` | `./models` | Directory containing GGUF model files |
           | `PORT` | `3001` | API + UI server port |
           | `AUDIO_DIR` | `./public/audio` | Where generated audio is stored |

README.md

@@ -116,8 +116,8 @@ build.bat
 | `--bin DIR` | Custom binary output directory (default: `./bin`) |
 
 After a successful build, three binaries are installed to `./bin/`:
-- `ace-qwen3` — text encoder
-- `dit-vae` — diffusion + VAE decoder
+- `ace-lm` — text encoder
+- `ace-synth` — diffusion + VAE decoder
 - `neural-codec` — audio codec
 
 ### Step 3: Download GGUF models
@@ -246,8 +246,8 @@ MODELS_DIR=./models
 
 # ── acestep-cpp binaries — auto-detected from ./bin/ after ./build.sh ─────────
 # Override only if your binaries live outside ./bin/:
-# ACE_QWEN3_BIN=/path/to/ace-qwen3
-# DIT_VAE_BIN=/path/to/dit-vae
+# ACE_LM_BIN=/path/to/ace-lm
+# ACE_SYNTH_BIN=/path/to/ace-synth
 # ACESTEP_MODEL=/path/to/models/acestep-v15-turbo-Q8_0.gguf  # override DiT model
 
 # Mode 2 (advanced): connect to a separately running acestep-cpp HTTP server

build.bat

@@ -118,7 +118,7 @@ if %ERRORLEVEL% NEQ 0 ( echo cmake build failed & exit /b 1 )
 :: Copy binaries
 if not exist "%BIN_DIR%" mkdir "%BIN_DIR%"
 set COPIED=0
-for %%N in (ace-qwen3 dit-vae ace-understand neural-codec) do (
+for %%N in (ace-lm ace-synth ace-understand neural-codec) do (
     set FOUND=
     for /r "%BUILD_DIR%" %%F in (%%N.exe) do (
         if exist "%%F" if "!FOUND!"=="" set FOUND=%%F

build.sh

@@ -137,7 +137,7 @@ cmake --build "$BUILD_DIR" --parallel
 # ── Copy binaries to bin/ ─────────────────────────────────────────────────────
 mkdir -p "$BIN_DIR"
 copied=0
-for name in ace-qwen3 dit-vae ace-understand neural-codec; do
+for name in ace-lm ace-synth ace-understand neural-codec; do
     found=$(find "$BUILD_DIR" -name "$name" -type f 2>/dev/null | head -1)
     if [ -n "$found" ]; then
         cp "$found" "$BIN_DIR/$name"

components/CreatePanel.tsx

@@ -2433,7 +2433,7 @@ export const CreatePanel: React.FC<CreatePanelProps> = ({
                 <span className="relative group/tip inline-flex">
                   <Info size={12} className="text-zinc-400 cursor-help" />
                   <span className="pointer-events-none absolute hidden group-hover/tip:block bottom-5 left-0 z-50 w-56 rounded-lg bg-zinc-900 px-3 py-2 text-[10px] text-zinc-200 shadow-xl border border-white/10">
-                    MP3 (default): native binary output, smaller file. WAV: lossless, passes --wav flag to dit-vae.
+                    MP3 (default): native binary output, smaller file. WAV: lossless, passes --wav flag to ace-synth.
                   </span>
                 </span>
               </div>
@@ -2460,9 +2460,9 @@ export const CreatePanel: React.FC<CreatePanelProps> = ({
               </p>
             </div>
 
-            {/* ── DiT flow matching (dit-vae) ──────────────────────── */}
+            {/* ── DiT flow matching (ace-synth) ──────────────────────── */}
             <div className="flex items-center gap-2 pt-1">
-              <span className="text-[10px] font-bold text-zinc-400 uppercase tracking-widest whitespace-nowrap">DiT flow matching (dit-vae)</span>
+              <span className="text-[10px] font-bold text-zinc-400 uppercase tracking-widest whitespace-nowrap">DiT flow matching (ace-synth)</span>
               <div className="flex-1 border-t border-zinc-200 dark:border-white/10" />
             </div>
 
@@ -2501,10 +2501,10 @@ export const CreatePanel: React.FC<CreatePanelProps> = ({
               helpText="Flow-matching schedule shift — controls the timestep distribution (shift = s·t / (1+(s−1)·t)). Turbo preset: 3.0. SFT/lego preset: 1.0. Values near 1.0 give a linear schedule; higher values front-load denoising."
             />
 
-            {/* ── LM sampling (ace-qwen3) ──────────────────────────── */}
+            {/* ── LM sampling (ace-lm) ──────────────────────────── */}
             <>
               <div className="flex items-center gap-2 pt-1">
-                  <span className="text-[10px] font-bold text-zinc-400 uppercase tracking-widest whitespace-nowrap">LM sampling (ace-qwen3)</span>
+                  <span className="text-[10px] font-bold text-zinc-400 uppercase tracking-widest whitespace-nowrap">LM sampling (ace-lm)</span>
                   <div className="flex-1 border-t border-zinc-200 dark:border-white/10" />
                 </div>
 
@@ -2515,7 +2515,7 @@ export const CreatePanel: React.FC<CreatePanelProps> = ({
                     <span className="relative group/tip inline-flex">
                       <Info size={12} className="text-zinc-400 cursor-help" />
                       <span className="pointer-events-none absolute hidden group-hover/tip:block bottom-5 left-0 z-50 w-56 rounded-lg bg-zinc-900 p-2 text-[10px] leading-relaxed text-white shadow-xl">
-                        ace-qwen3 model size. 0.6B is fastest; 4B produces the best lyrics and captions.
+                        ace-lm model size. 0.6B is fastest; 4B produces the best lyrics and captions.
                       </span>
                     </span>
                   </div>
@@ -2629,7 +2629,7 @@ export const CreatePanel: React.FC<CreatePanelProps> = ({
                 <span className="relative group/tip inline-flex">
                   <Info size={12} className="text-zinc-400 cursor-help" />
                   <span className="pointer-events-none absolute hidden group-hover/tip:block bottom-5 left-0 z-50 w-64 rounded-lg bg-zinc-900 p-2 text-[10px] leading-relaxed text-white shadow-xl">
-                    Comma-separated FSQ token IDs produced by ace-qwen3. When non-empty, the entire LLM pass is skipped and dit-vae decodes these codes directly (passthrough mode).
+                    Comma-separated FSQ token IDs produced by ace-lm. When non-empty, the entire LLM pass is skipped and ace-synth decodes these codes directly (passthrough mode).
                   </span>
                 </span>
               </div>

docs/electron-local-testing.md

@@ -46,7 +46,7 @@ Both archives are flat tarballs (no subdirectory).  Run the command for your pla
 mkdir -p bin
 
 curl -fsSL --retry 3 \
-  https://github.com/audiohacking/acestep.cpp/releases/download/v0.0.1/acestep-macos-arm64-metal.tar.gz \
+  https://github.com/audiohacking/acestep.cpp/releases/download/v0.0.2/acestep-macos-arm64-metal.tar.gz \
   -o acestep-macos-arm64-metal.tar.gz
 
 echo "Archive contents:"
@@ -67,7 +67,7 @@ ls -lh bin/
 mkdir -p bin
 
 curl -fsSL --retry 3 \
-  https://github.com/audiohacking/acestep.cpp/releases/download/v0.0.1/acestep-linux-x64.tar.gz \
+  https://github.com/audiohacking/acestep.cpp/releases/download/v0.0.2/acestep-linux-x64.tar.gz \
   -o acestep-linux-x64.tar.gz
 
 echo "Archive contents:"
@@ -93,7 +93,7 @@ Run:
 ```bash
 GGML_VER="0.9.7"
 ok=1
-for bin in ace-qwen3 dit-vae neural-codec; do
+for bin in ace-lm ace-synth neural-codec; do
   [ -f "bin/$bin" ] && [ -x "bin/$bin" ] \
     && echo "✅  bin/$bin" \
     || { echo "❌  bin/$bin — missing or not executable"; ok=0; }
@@ -116,7 +116,7 @@ Run:
 
 ```bash
 ok=1
-for bin in ace-qwen3 dit-vae neural-codec; do
+for bin in ace-lm ace-synth neural-codec; do
   [ -f "bin/$bin" ] && [ -x "bin/$bin" ] \
     && echo "✅  bin/$bin" \
     || { echo "❌  bin/$bin — missing or not executable"; ok=0; }
@@ -192,7 +192,7 @@ While the app is running, open a second terminal and confirm the environment var
 ### macOS
 
 ```bash
-# Find the ace-qwen3 / dit-vae child process (if a generation is running) or
+# Find the ace-lm / ace-synth child process (if a generation is running) or
 # inspect the Electron main process env via the logs directory:
 cat ~/Library/Application\ Support/ACE-Step\ UI/logs/server.log | grep -i "DYLD"
 ```
@@ -259,7 +259,7 @@ libggml-base.so.0 -> libggml-base.so
 1. With models present (or after downloading them), enter a short prompt such as `upbeat electronic music`
 2. Set **Duration** to `5s` in the Advanced panel to keep the test fast
 3. Click **Generate**
-4. Watch the Debug tab — you should see `ace-qwen3` and `dit-vae` output lines appear
+4. Watch the Debug tab — you should see `ace-lm` and `ace-synth` output lines appear
 5. The generated audio file should appear in the Songs list and be playable
 
 If the binaries fail to load their shared libraries you will see an error like:

electron/main.js

@@ -5,7 +5,7 @@
  * ─────────────────
  * 1. ensureDirs()            create user-space directories
  * 2. setupLibraryPaths()     set LD_LIBRARY_PATH (Linux) / DYLD_LIBRARY_PATH
- *                            (macOS) to BIN_DIR so that ace-qwen3 / dit-vae
+ *                            (macOS) to BIN_DIR so that ace-lm / ace-synth
  *                            child processes find their shared libraries.
  *                            Linux ELFs have a hardcoded RUNPATH to the CI
  *                            build tree; macOS dylibs use versioned install
@@ -124,7 +124,7 @@ function ensureDirs () {
 
 /**
  * Prepend BIN_DIR to the platform's dynamic-library search path so that the
- * ace-qwen3 / dit-vae child processes find their bundled shared libraries.
+ * ace-lm / ace-synth child processes find their bundled shared libraries.
  *
  * Linux: The ELFs have a hardcoded RUNPATH pointing to the CI build tree
  *   (/home/runner/work/…) which never exists on user machines.
@@ -231,10 +231,10 @@ async function startServer () {
     process.env.JWT_SECRET = 'ace-step-ui-electron-local-secret';
   }
 
-  const aceQwen3 = path.join(BIN_DIR, `ace-qwen3${binExt}`);
-  const ditVae   = path.join(BIN_DIR, `dit-vae${binExt}`);
-  if (fs.existsSync(aceQwen3)) process.env.ACE_QWEN3_BIN = aceQwen3;
-  if (fs.existsSync(ditVae))   process.env.DIT_VAE_BIN   = ditVae;
+  const aceLm    = path.join(BIN_DIR, `ace-lm${binExt}`);
+  const aceSynth = path.join(BIN_DIR, `ace-synth${binExt}`);
+  if (fs.existsSync(aceLm))    process.env.ACE_LM_BIN    = aceLm;
+  if (fs.existsSync(aceSynth)) process.env.ACE_SYNTH_BIN = aceSynth;
 
   // In packaged mode redirect server stdout/stderr to a persistent log file
   if (isPackaged) {