.env.example

# ACE-Step UI — Configuration
# Copy this file to .env and fill in your values.

# ── Server ────────────────────────────────────────────────────────────────────
PORT=3001
NODE_ENV=development

# ── Database (SQLite) ─────────────────────────────────────────────────────────
DATABASE_PATH=./data/acestep.db

# ── Model storage ─────────────────────────────────────────────────────────────
# Directory where GGUF model files are stored.
# Run ./models.sh to download the default Q8_0 essential set (~8 GB).
MODELS_DIR=./models

# Electron desktop app: MODELS_DIR is resolved in this priority order:
#   1. MODELS_DIR env var set before launching (e.g. export MODELS_DIR=/my/models)
#   2. Path chosen via the "Browse for existing models…" dialog (saved in prefs.json)
#   3. Default: <userData>/models  (macOS: ~/Library/Application Support/ACE-Step UI/models)
#                                  (Linux: ~/.config/ACE-Step UI/models)
# Setting MODELS_DIR in the environment lets you reuse a shared models folder
# across multiple tools without copying or re-downloading the ~8 GB model set.

# ── acestep-cpp: two modes, pick ONE ─────────────────────────────────────────
#
# Mode 1 (recommended, zero-config): binaries are auto-discovered in ./bin/
#   Run ./build.sh once; start-all.sh picks them up automatically.
#   No need to set anything below if you used ./build.sh.
#
# Override individual binary paths only if they live outside ./bin/:
# 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:
# ACESTEP_MODEL=/path/to/models/acestep-v15-turbo-Q8_0.gguf
#
# Override the base DiT GGUF used for lego mode (auto-detected from models/ by default):
# ACESTEP_BASE_MODEL=/path/to/models/acestep-v15-base-Q8_0.gguf

# Mode 2 (advanced): Connect to a separately running acestep-cpp HTTP server.
#   Leave the above unset and configure ACESTEP_API_URL instead.
#
# ACESTEP_API_URL=http://localhost:7860

# ── acestep-cpp source / custom fork ─────────────────────────────────────────
# Override the repository cloned by build.sh (useful for custom forks):
# ACESTEP_CPP_REPO=https://github.com/your-fork/acestep.cpp.git
#
# Checkout a specific branch or tag after cloning:
# ACESTEP_CPP_BRANCH=main

# ── Storage ───────────────────────────────────────────────────────────────────
# Audio directory for generated songs and uploaded reference tracks.
# Relative paths are resolved from the project root (APP_ROOT).
# This is the single source of truth: LocalStorageProvider (writes),
# Express /audio/ endpoint (serves), and the spawn service (reads) all use it.
AUDIO_DIR=./server/public/audio

# ── Auth ──────────────────────────────────────────────────────────────────────
# Change this to a long random string in any multi-user or network-exposed setup.
JWT_SECRET=ace-step-ui-local-secret

# ── HuggingFace token (optional) ──────────────────────────────────────────────
# Required only for private or gated HuggingFace repositories.
# HF_TOKEN=hf_...

# ── Optional ──────────────────────────────────────────────────────────────────
# Pexels API key for video backgrounds — https://www.pexels.com/api/
# PEXELS_API_KEY=

# ── Binary extra arguments ────────────────────────────────────────────────────
# 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_LM_EXTRA_ARGS=--threads 4
#   ACE_SYNTH_EXTRA_ARGS=--threads 4
#
# ACE_SYNTH_EXTRA_ARGS=
# ACE_LM_EXTRA_ARGS=