From fe2acdf45fddffe2c96f604814ef60b52bc86ab6 Mon Sep 17 00:00:00 2001 From: oobabooga <112222186+oobabooga@users.noreply.github.com> Date: Fri, 22 Sep 2023 15:52:20 -0300 Subject: [PATCH] Update README.md --- README.md | 27 ++++++++++++++++++++------- 1 file changed, 20 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index c3bfe137..b90d04cd 100644 --- a/README.md +++ b/README.md @@ -30,15 +30,28 @@ To learn how to use the various features, check out the Documentation: https://g ### One-click installers -| Windows | Linux | macOS | WSL | -|--------|--------|--------|--------| -| [oobabooga-windows.zip](https://github.com/oobabooga/text-generation-webui/releases/download/installers/oobabooga_windows.zip) | [oobabooga-linux.zip](https://github.com/oobabooga/text-generation-webui/releases/download/installers/oobabooga_linux.zip) |[oobabooga-macos.zip](https://github.com/oobabooga/text-generation-webui/releases/download/installers/oobabooga_macos.zip) | [oobabooga-wsl.zip](https://github.com/oobabooga/text-generation-webui/releases/download/installers/oobabooga_wsl.zip) | +1) Run the `start_linux.sh`, `start_windows.bat`, `start_macos.sh`, or `start_wsl.bat` script depending on your OS. +2) Select your GPU vendor when asked. +3) Have fun! -Just download the zip above, extract it, and double-click on "start". The web UI and all its dependencies will be installed in the same folder. +#### More information -* The source codes and more information can be found here: https://github.com/oobabooga/one-click-installers -* There is no need to run the installers as admin. -* Huge thanks to [@jllllll](https://github.com/jllllll), [@ClayShoaf](https://github.com/ClayShoaf), and [@xNul](https://github.com/xNul) for their contributions to these installers. +The script will create a folder called `installer_files` where it will download Miniconda, create a Conda environment, and install the webui requirements. The installation is self-contained: if you want to reinstall, just delete `installer_files` and run the start script again. + +The same `start` script should be used to launch the webui in the future after it is already installed. + +To update, run `update_linux.sh`, `update_windows.bat`, `update_macos.sh`, or `update_wsl.bat`. + +To run commands in the `installer_files` environment, run the appropriate cmd script: `cmd_linux.sh`, `cmd_windows.bat`, `cmd_macos.sh`, or `cmd_wsl.bat`. + +To define persistent command-line flags like `--listen` or `--api`, edit the `CMD_FLAGS.txt` file with a text editor and add them there. Flags can also be provided directly to the start scripts, for instance, `./start-linux.sh --listen`. + +Some observations: + +* There is no need to run any of those scripts as admin/root. +* If you need to move your installation folder, you will need to delete `installer_files` and install again, as some links will be broken. So choose a good location for your `text-generation-webui` folder before installing. +* Additional instructions for WSL and AMD users can be found here: [Instructions](https://github.com/oobabooga/text-generation-webui/blob/one-click/docs/new/Installation%20Instructions.md). +* The installer has been tested mostly on NVIDIA GPUs. If you can find a way to improve it for your AMD/Intel Arc/Mac Metal GPU, you are highly encouraged to submit a PR to this repository. ### Manual installation using Conda