GKaszewski/StableAudioWebUI
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Refactor code structure for improved readability and maintainability

Browse Source
This commit is contained in:
Gabriel Kaszewski
2025-08-24 12:05:41 +02:00
parent 34f76242e6
commit c5ceea27b4
5 changed files with 4276 additions and 80 deletions
Download Patch File Download Diff File Expand all files Collapse all files

71
README.md
View File

@@ -1,35 +1,32 @@
<div align="center">
MY FORK OF
(modified to use uv and local models)
# 💀🔊 StableAudioWebUI 💀🔊
[![Hugging Face](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Space-red)](https://huggingface.co/spaces/ameerazam08/stableaudio-open-1.0)
### A Lightweight Gradio Web interface for running Stable Audio Open 1.0
By *[@drbaph](https://instagram.com/drbaph)*
By _[@drbaph](https://instagram.com/drbaph)_
<br>
<br>
![image_2024-06-10_21-03-05](https://github.com/Saganaki22/StableAudioWebUI/assets/84208527/b3f4bd5a-04ec-4802-aabc-dcaea4882f51)
<br>
<br>
![image_2024-06-10_21-02-10](https://github.com/Saganaki22/StableAudioWebUI/assets/84208527/526d72f3-abf2-499c-af18-654025a305ba)
<br>
### Example
https://github.com/Saganaki22/StableAudioWebUI/assets/84208527/30063999-9ca6-4a86-8721-65e3cba4c87d
---
# ⚠ Disclaimer ⚠
@@ -37,8 +34,9 @@ https://github.com/Saganaki22/StableAudioWebUI/assets/84208527/30063999-9ca6-4a8
### I am not responsible for any content generated using this repository. By using this repository, you acknowledge that you are bound by the [Stability AI license agreement](https://huggingface.co/stabilityai/stable-audio-open-1.0/blob/main/LICENSE) and will only use this model for research or personal purposes. No commercial usage is allowed! <br>
---
### Recommended Settings
Prompt: Any <br>
Sampler: dpmpp-3m-sde <br>
CFG: 7 <br>
@@ -48,6 +46,7 @@ Duration: Max 47s <br>
Seed: Any <br>
### > Saves Files in the following directory Output/YYYY-MM-DD/ <br>
### > using the following schema 'your_prompt.mp3' <br>
</div>
@@ -58,15 +57,16 @@ Seed: Any <br>
<br>
✅ Added (`Random_Seed`) Checkbox
✅ Added (`Random_Seed`) Checkbox
<br>
✅ **Implemented Enhanced Filename Handling and Security Measures** <br>
- **Filename Length Control**: Truncated long prompts to a maximum of 50 characters for filenames, preventing excessively long filenames. <br>
- **Enhanced Sanitization**: Applied strict rules to replace non-alphanumeric characters with underscores (`_`), ensuring valid and safe filenames. <br>
- **Unique Filename Generation**: Introduced a system to append numeric suffixes to filenames to avoid overwriting existing files, ensuring each file is uniquely named. <br>
- **Safe Directory Handling**: Utilized secure methods for path creation and directory handling to avoid risks from user input influencing file paths. <br>
- **Filename Length Control**: Truncated long prompts to a maximum of 50 characters for filenames, preventing excessively long filenames. <br>
- **Enhanced Sanitization**: Applied strict rules to replace non-alphanumeric characters with underscores (`_`), ensuring valid and safe filenames. <br>
- **Unique Filename Generation**: Introduced a system to append numeric suffixes to filenames to avoid overwriting existing files, ensuring each file is uniquely named. <br>
- **Safe Directory Handling**: Utilized secure methods for path creation and directory handling to avoid risks from user input influencing file paths. <br>
<details>
<summary style="font-size: 28px;"><b>Click to expand for earlier updates</b></summary>
@@ -93,29 +93,28 @@ Seed: Any <br>
✅ Updated UI elements to include Advanced Parametres dropdown <br>
*( CFG Scale, Sigma_min, Sigma_max )* <br>
_( CFG Scale, Sigma_min, Sigma_max )_ <br>
✅ Added Use Half precision checkbox for Low VRAM inference <br>
*( Float 16 )*
_( Float 16 )_
✅ Added choice for all Sampler types <br>
*( dpmpp-3m-sde, dpmpp-2m-sde, k-heun, k-lms, k-dpmpp-2s-ancestral, k-dpm-2, k-dpm-fast )* <br>
_( dpmpp-3m-sde, dpmpp-2m-sde, k-heun, k-lms, k-dpmpp-2s-ancestral, k-dpm-2, k-dpm-fast )_ <br>
✅ Added link to the Repo <br>
</details>
---
### 📝 Note: For Windows builds with [Nvidia](https://github.com/Saganaki22/StableAudioWebUI/releases/download/latest/One-Click-Installer-GPU.bat) 30xx + or Float32 Capable [CPU](https://github.com/Saganaki22/StableAudioWebUI/releases/download/latest/One-Click-Installer-CPU.bat) you can use the [One-Click-Installer.bat](https://github.com/Saganaki22/StableAudioWebUI/releases/tag/latest) to simplify the process, granted you have logged in to huggingface-cli and auth'd your token prior to running the batch script: Step 3 (the huggingface-cli is used for obtaining the model file)
## Step 1: Start by cloning the repo:
### 📝 Note: For Windows builds with [Nvidia](https://github.com/Saganaki22/StableAudioWebUI/releases/download/latest/One-Click-Installer-GPU.bat) 30xx + or Float32 Capable [CPU](https://github.com/Saganaki22/StableAudioWebUI/releases/download/latest/One-Click-Installer-CPU.bat) you can use the [One-Click-Installer.bat](https://github.com/Saganaki22/StableAudioWebUI/releases/tag/latest) to simplify the process, granted you have logged in to huggingface-cli and auth'd your token prior to running the batch script: Step 3 (the huggingface-cli is used for obtaining the model file)
## Step 1: Start by cloning the repo:
git clone https://github.com/Saganaki22/StableAudioWebUI.git
## Step 2: Use the below deployment (tested on 24GB Nvidia VRAM but should work with 12GB too as we have added the Load Half precision, Float16 option in the WebUI):
cd StableAudioWebUI
@@ -124,7 +123,6 @@ Seed: Any <br>
pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121
pip install -r requirements.txt
## (Note if you have an older Nvidia GPU you may need to use CUDA 11.8)
pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118
@@ -133,22 +131,23 @@ Step 3: (Optional - read more): If you haven't got a hugging face account or hav
huggingface-cli login
(paste your token and follow the instructions, token will not be displayed when pasted)
(paste your token and follow the instructions, token will not be displayed when pasted)
## If you want to run it using CPU <br>
omit 'pip install torch torchvision --index-url https://download.pytorch.org/whl/cu121' and the process after it and just run
## If you want to run it using CPU <br>
omit 'pip install torch torchvision --index-url https://download.pytorch.org/whl/cu121' and the process after it and just run
pip install -r requirements1.txt
pip install -r requirements.txt
## Step 4: Run
python gradio_app.py
<br>
## ⭐ Bonus
If you are using Windows and followed my setup instructions you could create a batch script to activate the enviroment and run the script all in one, what you need to do is: <br>
<br>
Create a new text file in the same folder as gradio_app.py & paste this in the text file
@@ -160,23 +159,22 @@ Create a new text file in the same folder as gradio_app.py & paste this in the t
pause
then save the file as run.bat
# Screenshots (older build)
(All with random seeds) <br>
Prompt: a dog barking <br>
CFG: 7 <br>
Sigma_Min: 0.3 <br>
Sigma_Max: 500 <br>
![image](https://github.com/Saganaki22/StableAudioWebUI/blob/main/assets/screenshot1.png) <br>
https://github.com/Saganaki22/StableAudioWebUI/assets/84208527/4ca9eb1b-2808-4f39-b7e3-f35c736eb7b7
#
<br>
Prompt: people clapping <br>
CFG: 7 <br>
@@ -185,13 +183,10 @@ Sigma_Max: 500 <br>
![image](https://github.com/Saganaki22/StableAudioWebUI/blob/main/assets/screenshot2.png) <br>
https://github.com/Saganaki22/StableAudioWebUI/assets/84208527/1f333384-d4e6-4167-abec-5167e2f4822f
#
<br>
Prompt: didgeridoo <br>
CFG: 7 <br>
@@ -200,12 +195,8 @@ Sigma_Max: 500 <br>
![image](https://github.com/Saganaki22/StableAudioWebUI/blob/main/assets/screenshot3.png) <br>
https://github.com/Saganaki22/StableAudioWebUI/assets/84208527/1cb7ce3b-7463-46a8-ba9a-3a5aa232d43a
---
## Model Details
@@ -218,13 +209,13 @@ https://github.com/Saganaki22/StableAudioWebUI/assets/84208527/1cb7ce3b-7463-46a
<div align="center">
#
![image](https://huggingface.co/datasets/huggingface/brand-assets/resolve/main/hf-logo-with-title.png)
### [Huggingface](https://huggingface.co/stabilityai/stable-audio-open-1.0) | [Stable Audio Tools](https://github.com/Stability-AI/stable-audio-tools) | [Stability AI](https://stability.ai/news/introducing-stable-audio-open)
### [Huggingface](https://huggingface.co/stabilityai/stable-audio-open-1.0) | [Stable Audio Tools](https://github.com/Stability-AI/stable-audio-tools) | [Stability AI](https://stability.ai/news/introducing-stable-audio-open)
---
![drbaph](https://github.com/Saganaki22/StableAudioWebUI/assets/84208527/13432252-e640-4c98-a7ab-4d57e6b56059)
</div>