acestep.cpp-simple-GUI

May 12, 2026 ยท View on GitHub

Another super simple web interface for something because im too lazy to type.

This simply creates the json for you, and passes it into the command line to run the generations. With a super simple GUI.

Current features:

  • It presents all the variables to you, with defaults.
  • Lets you process your prompt using the OEM LLM, and have it fill in the results for you to edit, or totally dismss and try again before actual music generation.
  • Audio preview feature, and will let you download the jsons and output as a zip.
  • Supports uploading a reference audio track.
  • Supports selecting the synth model ( hard coded ).
  • Rcentely added cover task features.
  • You can also now save the current settings as an an arbitrary json file for safe keeping without having to call the generate or llm-enhance,or llm-analyze as well as load it back in.
  • Exporting results to zip now includes any cover files used.
  • Auto cleanup is gone so you don't lose something by accdient, but there is now a manual cleanup button.
  • For those of us with older GPUs that produce silence, there is now an option in the GUI for this, no need to pass a paramater now. just selct "-clamp-fp16" in the "addtional args" area before generation.

And, tho im not real fond of its accuracy on actual lyrics, we just added an "llm-Analyze" option, to feed the reference audio into the OEM llm ( using the cli defaults ). It will feed the results of its analysis back into the GUI for review/edit/removal/redo, much like LLM-Enhance does, only this time its just listening to the audio track, and not the text you have entered. It does an ok job on structure, so figured it might be of use to have it.

To get started, either compile or download binaries for your platform from https://github.com/ServeurpersoCom/acestep.cpp and drop them into the bin folder.

Then get the minimum required ggufs and drop them into the models folder. ( also documented on the above repo ): acestep-5Hz-lm-4B-Q8_0.gguf, acestep-v15-turbo-Q8_0.gguf, Qwen3-Embedding-0.6B-Q8_0.gguf, vae-BF16.gguf. I suggest you also get XL versions, but its not required. ( but watch it as the defaut now is XL )

Be sure to grab python dependencies from the requirements.txt file, which is minimal as always - in this case just flask and python-dotenv

And once again, obligatory ( updated for current featureset ) screenshot:

image