Skip to content

Commit

Permalink
better readme
Browse files Browse the repository at this point in the history
  • Loading branch information
blaise-tk committed Feb 21, 2024
1 parent db6e584 commit 61587a1
Showing 1 changed file with 29 additions and 25 deletions.
54 changes: 29 additions & 25 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,50 +1,54 @@
# VoRAS: Vocos Retrieval and self-Augmentation for Speech

VoRAS is a model designed for fast and lightweight real-time voice modification in Japanese, derived from RVC.
VoRAS is a model designed for fast and lightweight voice cloning built upon [RVC](https://github.com/RVC-Project/Retrieval-based-Voice-Conversion-WebUI), with the enhancement of utilizing [Vocos](https://github.com/gemelo-ai/vocos) as a replacement for the vocoder, and a restructuring of the overall model architecture to a more modern design.

## Overview
> [!IMPORTANT]
> VoRAS is still in the experimental development phase.
VoRAS is built upon RVC, with the enhancement of utilizing Vocos as a replacement for the vocoder, and a restructuring of the overall model architecture to a more modern design.
## Installation

## Note
## Installation

Development of VoRAS has been discontinued due to the absence of anticipated further improvements in performance. Feel free to fork this repository if you wish to experiment with it further.
### Windows

# Launch

## Windows
```bash
./run-install.bat
```

To start the web UI, run `./install.bat` and `python env/app.py` script.
### Linux

```
Tested environment: Windows 10, Python 3.10.9, torch 2.0.0+cu118
```bash
chmod +x run-install.sh
./run-install.sh
```

# Troubleshooting
### Using Makefile (for platforms such as [Paperspace](https://www.paperspace.com/))

## `error: Microsoft Visual C++ 14.0 or greater is required.`
```
make run-install
```

If you encounter this error, you need to install Microsoft C++ Build Tools.
## Usage

### Step 1: Download the installer
### Windows

[Download Microsoft C++ Build Tools](https://visualstudio.microsoft.com/ja/thank-you-downloading-visual-studio/?sku=BuildTools&rel=16)
```bash
./run-voras.bat
```

### Step 2: Install `C++ Build Tools`
### Linux

Run the installer and select `C++ Build Tools` in the `Workloads` tab.
```bash
chmod +x run-voras.sh
./run-voras.sh
```

# Credits

VoRAS acknowledges the following projects and resources for their contributions:

- [liujing04/Retrieval-based-Voice-Conversion-WebUI](https://github.com/liujing04/Retrieval-based-Voice-Conversion-WebUI)
- [RVC-Project/Retrieval-based-Voice-Conversion-WebUI](https://github.com/RVC-Project/Retrieval-based-Voice-Conversion-WebUI)
- [nadare881/voras-webui-beta](https://github.com/nadare881/voras-webui-beta)
- [charactr-platform/Vocos](https://github.com/charactr-platform/vocos)
- [ddPn08/rvc-webui](https://github.com/ddPn08/rvc-webui/tree/main)
- [NVIDIA/BigVGAN](https://github.com/NVIDIA/BigVGAN)
- [rinna/japanese-hubert-base](https://huggingface.co/rinna/japanese-hubert-base)
- [teftef6220/Voice_Separation_and_Selection](https://github.com/teftef6220/Voice_Separation_and_Selection)
- [あみたろの声素材工房](https://amitaro.net/)
- [つくよみちゃん](https://tyc.rei-yumesaki.net/)
- [刻鳴時雨 ITA コーパス読み上げ音声素材](https://booth.pm/ja/items/3640133)
- [れぷりかどーる](https://kikyohiroto1227.wixsite.com/kikoto-utau)

0 comments on commit 61587a1

Please sign in to comment.