Reading the repo
Opening the box…
Reading the repo
Opening the box…
How to install on macOS
Create songs from lyrics and a style on your own computer. Local AI music studio with YuE2 via audio.cpp, stem separation and section editing.
Saved setup from 2 h ago
Will it work on macOS?
The maintainers included scripts/setup.sh. Run it from the cloned folder after reading it.
bash scripts/setup.sh
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
Needs Git: xcode-select --install
git clone https://github.com/lvxworld/lux-in-music.git cd lux-in-music
Python >=3.11
brew install uv
uv sync
This guide covers macOS on Apple Silicon. Linux has a CPU setup path described in the technical reference; a native Windows installer is not provided.
Open Terminal: press Command + Space, type Terminal, then press Return.
Copy this command into Terminal and press Return:
xcode-select --install
Follow Apple's installation window and wait for it to finish. These are the Apple tools that Lux needs to prepare its audio engine. If Terminal says they are already installed, continue to step 2.
lux-in-music-v….zip, which contains the complete
app source for that version.For an earlier version, open all releases and download its ZIP the same way. The green Code → Download ZIP button gives the newest source instead, without a version number.
In Terminal, go into the folder you just extracted:
cd, then press the Space key.Copy this command into Terminal and press Return:
./studio.sh
On the first launch, Lux automatically prepares Python, its software dependencies and the audio engine. You do not need to install Python, uv, CMake or Homebrew separately. This step can take several minutes.
Terminal shows four stages:
| Stage | What happens | | --- | --- | | 1/4 | Check the required tools | | 2/4 | Prepare Python and the app | | 3/4 | Download and build the audio engine | | 4/4 | Start Lux and open your browser |
Many lines of build output are normal. Wait until the app starts, and keep Terminal open while you use Lux. If the browser does not open, visit http://127.0.0.1:8000 after stage 4.
This installs software only. Models are chosen separately in Settings.
The first launch opens Settings because no model is active yet. A model is what creates the music; its files must be downloaded before you can create songs.
The download and short compatibility test can take a while. You can cancel and retry a download. Optional separation models are for splitting a song into vocals and instruments; you can leave them uninstalled for now.
Read the model license notes before choosing a model for commercial use. Licenses are shown before each download.
Open Settings and find EmbeddingGemma 2. Review its Apache-2.0 license
(Google's Gemma 4 license), then select I have reviewed and accept these model
terms and click Download and prepare Vibe. Lux downloads the pinned model
files to your computer (about 1.53 GB) and verifies them. This is separate from
YuE2 and does not change your music model. If Hugging Face asks for access,
accept its model terms on the linked model page and sign in from Terminal with
hf auth login before retrying.
Choose Vibe in the sidebar and add 1–5 JPG, PNG or WebP images, up to 20 MB each. Remove or reorder them with the thumbnail controls, then click Analyze Images. Lux comp
…
No reports for macOS yet.
GitManual AI Agent reads the 5 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.