audio-webui / readme.md
mrtroydev's picture
Upload folder using huggingface_hub
3883c60 verified
# <img alt="logo" height="25" src="assets/logo.png" width="25"/> Audio Webui <img alt="logo" height="25" src="assets/logo.png" width="25"/>
https://github.com/gitmylo/audio-webui/assets/36931363/c285b4dc-63cf-4b1c-895d-9723a2cbf91e
[![GitHub commit activity (branch)](https://img.shields.io/github/commit-activity/t/gitmylo/audio-webui)](https://github.com/gitmylo/audio-webui/commits/master)
[![GitHub contributors](https://img.shields.io/github/contributors-anon/gitmylo/audio-webui)](https://github.com/gitmylo/audio-webui/graphs/contributors)
[![GitHub all releases](https://img.shields.io/github/downloads/gitmylo/audio-webui/total?label=installer%20downloads)](https://github.com/gitmylo/audio-webui/releases/tag/Installers)
[![GitHub Sponsors](https://img.shields.io/github/sponsors/gitmylo?label=github+sponsors+supporters)](https://github.com/sponsors/gitmylo)
[![Discord](https://img.shields.io/discord/1118525872882843711?style=flat&label=discord)](https://discord.gg/NB86C3Szkg)
## ❗❗ Please read ❗❗
This code works on python 3.10 (lower versions don't support "|" type annotations, and i believe 3.11 doesn't have support for the TTS library currently).
You also need to have [Git](https://git-scm.com/downloads) installed, you might already have it, run `git --version` in a console/terminal to see if you already have it installed.
Some features require [ffmpeg](http://ffmpeg.org/) to be installed.
On Windows, you need to have visual studio C++ build tools installed.
[Common issues](https://github.com/gitmylo/audio-webui/blob/master/readme/common_issues.md)
<!-- TOC -->
* [<img alt="logo" height="15" src="assets/logo.png" width="15"/> Audio Webui <img alt="logo" height="15" src="assets/logo.png" width="15"/>](#img-altlogo-height25-srcassetslogopng-width25-audio-webui-img-altlogo-height25-srcassetslogopng-width25)
* [❗❗ Please read ❗❗](#-please-read-)
* [Latest big features](#latest-big-features)
* [πŸ‘ Automatic installers](#-automatic-installers)
* [πŸ“¦ Docker](#-docker)
* [πŸ’» Local install (Manual)](#-local-install-manual)
* [πŸ”½ Downloading](#-downloading)
* [πŸ“¦ Installing](#-installing)
* [πŸ”Ό Updating](#-updating)
* [πŸƒβ€ Running](#-running)
* [πŸ’» Google colab notebook](#-google-colab-notebook)
* [πŸ’» Common command line flags](#-common-command-line-flags)
* [✨ Current goals and features ✨](#-current-goals-and-features-)
* [More readme](#more-readme)
<!-- TOC -->
## Latest big features
* Extensions
## πŸ‘ Automatic installers
[Automatic installers! (Download)](https://github.com/gitmylo/audio-webui/releases/tag/Installers)
1. Put the installer in a folder
2. Run the installer for your operating system.
3. Now run the webui's install script. Follow the steps at [πŸ“¦ Installing](#-installing)
## πŸ“¦ Docker
<details>
<summary>Links to community audio-webui docker projects</summary>
* https://github.com/LajaSoft/audio-webui-docker (Docker compose which downloads jacen92's fork)
* https://github.com/jacen92/audio-webui-docker (Fork of audio-webui which includes docker compose)
</details>
Note: The docker repositories are not maintained by me. And docker related issues should go to the docker repositories.
If an issue is related to audio-webui directly, create the issue here. Unless a fix has already been made.
## πŸ’» Local install (Manual)
### πŸ”½ Downloading
It is recommended to use git to download the webui, using git allows for easy updating.
To download using git, run `git clone https://github.com/gitmylo/audio-webui` in a console/terminal
### πŸ“¦ Installing
Installation is done automatically in a venv when you run `run.bat` or `run.sh` (.bat on Windows, .sh on Linux/MacOS).
### πŸ”Ό Updating
To update,
run `update.bat` on windows, `update.sh` on linux/macos
OR run `git pull` in the folder your webui is installed in.
### πŸƒβ€ Running
Running should be as simple as running `run.bat` or `run.sh` depending on your OS.
Everything should get installed automatically.
If there's an issue with running, please create an [issue](https://github.com/gitmylo/audio-webui/issues)
## πŸ’» Google colab notebook
[![Open in colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/gitmylo/audio-webui/blob/master/audio_webui_colab.ipynb) [![Open in github](https://img.shields.io/badge/Github-Open%20file-green)](audio_webui_colab.ipynb)
## πŸ’» Common command line flags
| Name | Args | Short | Usage | Description |
|-----------------|----------------------------------------|------------|-----------------------|------------------------------------------------------------------------------------------------------------------------|
| --skip-install | [None] | -si | -si | Skip installing packages |
| --skip-venv | [None] | -sv | -sv | Skip creating/activating venv, also skips install. (for advanced users) |
| --no-data-cache | [None] | [None] | --no-data-cache | Don't change the default dir for huggingface_hub models. (This might fix some models not loading) |
| --launch | [None] | [None] | --launch | Automatically open the webui in your browser once it launches. |
| --share | [None] | -s | -s | Share the gradio instance publicly |
| --username | username (str) | -u, --user | -u username | Set the username for gradio |
| --password | password (str) | -p, --pass | -p password | Set the password for gradio |
| --theme | theme (str) | [None] | --theme "gradio/soft" | Set the theme for gradio |
| --listen | [None] | -l | -l | Listen a server, allowing other devices within your local network to access the server. (or outside if port forwarded) |
| --port | port (int) | [None] | --port 12345 | Set a custom port to listen on, by default a port is picked automatically |
## ✨ Current goals and features ✨
moved to [a separate readme](https://github.com/gitmylo/audio-webui/tree/master/readme/features.md)
## More readme
[Link](https://github.com/gitmylo/audio-webui/tree/master/readme/readme.md)