|
1 | | -<h1 align="center"> |
2 | | - <a href="https://applio.org" target="_blank"><img src="https://github.com/IAHispano/Applio/assets/133521603/78e975d8-b07f-47ba-ab23-5a31592f322a" alt="Applio"></a> |
3 | | -</h1> |
| 1 | +# Retrieval-based Voice Conversion (RVC) CLI |
4 | 2 |
|
5 | | -<p align="center"> |
6 | | - <img alt="Contributors" src="https://img.shields.io/github/contributors/iahispano/applio?style=for-the-badge&color=FFFFFF" /> |
7 | | - <img alt="Release" src="https://img.shields.io/github/release/iahispano/applio?style=for-the-badge&color=FFFFFF" /> |
8 | | - <img alt="Stars" src="https://img.shields.io/github/stars/iahispano/applio?style=for-the-badge&color=FFFFFF" /> |
9 | | - <img alt="Fork" src="https://img.shields.io/github/forks/iahispano/applio?style=for-the-badge&color=FFFFFF" /> |
10 | | - <img alt="Issues" src="https://img.shields.io/github/issues/iahispano/applio?style=for-the-badge&color=FFFFFF" /> |
11 | | -</p> |
| 3 | +A stripped-down, command-line interface version of the Retrieval-based Voice Conversion (RVC) tool, optimized for performance and ease of integration. |
12 | 4 |
|
13 | | -<p align="center">A simple, high-quality voice conversion tool, focused on ease of use and performance.</p> |
| 5 | +## Features |
14 | 6 |
|
15 | | -<p align="center"> |
16 | | - <a href="https://applio.org" target="_blank">🌐 Website</a> |
17 | | - • |
18 | | - <a href="https://docs.applio.org" target="_blank">📚 Documentation</a> |
19 | | - • |
20 | | - <a href="https://discord.gg/urxFjYmYYh" target="_blank">☎️ Discord</a> |
21 | | -</p> |
| 7 | +- **CLI-Only**: No WebUI overhead (Gradio removed). |
| 8 | +- **Core ML Functionality**: Supports core RVC features including Inference, Training, and Preprocessing. |
| 9 | +- **Lightweight**: Minimized dependencies for easier deployment. |
22 | 10 |
|
23 | | -<p align="center"> |
24 | | - <a href="https://github.com/IAHispano/Applio-Plugins" target="_blank">🛒 Plugins</a> |
25 | | - • |
26 | | - <a href="https://huggingface.co/IAHispano/Applio/tree/main/Compiled" target="_blank">📦 Compiled</a> |
27 | | - • |
28 | | - <a href="https://applio.org/playground" target="_blank">🎮 Playground</a> |
29 | | - • |
30 | | - <a href="https://colab.research.google.com/github/iahispano/applio/blob/main/assets/Applio.ipynb" target="_blank">🔎 Google Colab (UI)</a> |
31 | | - • |
32 | | - <a href="https://colab.research.google.com/github/iahispano/applio/blob/main/assets/Applio_NoUI.ipynb" target="_blank">🔎 Google Colab (No UI)</a> |
33 | | -</p> |
| 11 | +## Installation |
34 | 12 |
|
35 | | -> [!NOTE] |
36 | | -> Applio will no longer receive frequent updates. Going forward, development will focus mainly on security patches, dependency updates, and occasional feature improvements. This is because the project is already stable and mature with limited room for further improvements. Pull requests are still welcome and will be reviewed. |
| 13 | +1. **Clone the repository**: |
| 14 | + ```bash |
| 15 | + git clone https://github.com/Acelogic/Retrieval-based-Voice-Conversion-MLX.git |
| 16 | + cd Retrieval-based-Voice-Conversion-MLX |
| 17 | + ``` |
37 | 18 |
|
38 | | -## Introduction |
| 19 | +2. **Install dependencies**: |
| 20 | + ```bash |
| 21 | + pip install -r requirements.txt |
| 22 | + ``` |
39 | 23 |
|
40 | | -Applio is a powerful voice conversion tool focused on simplicity, quality, and performance. Whether you're an artist, developer, or researcher, Applio offers a straightforward platform for high-quality voice transformations. Its flexible design allows for customization through plugins and configurations, catering to a wide range of projects. |
| 24 | + *Note: Ensure you have `ffmpeg` installed on your system if not using the python wrapper.* |
41 | 25 |
|
42 | | -## Terms of Use and Commercial Usage |
| 26 | +## Usage |
43 | 27 |
|
44 | | -Using Applio responsibly is essential. |
| 28 | +The main entry point is `rvc_cli.py`. You can see all available commands by running: |
45 | 29 |
|
46 | | -- Users must respect copyrights, intellectual property, and privacy rights. |
47 | | -- Applio is intended for lawful and ethical purposes, including personal, academic, and investigative projects. |
48 | | -- Commercial usage is permitted, provided users adhere to legal and ethical guidelines, secure appropriate rights and permissions, and comply with the [MIT license](./LICENSE). |
| 30 | +```bash |
| 31 | +python rvc_cli.py --help |
| 32 | +``` |
49 | 33 |
|
50 | | -The source code and model weights in this repository are licensed under the permissive [MIT license](./LICENSE), allowing modification, redistribution, and commercial use. |
| 34 | +### Common Commands |
51 | 35 |
|
52 | | -However, if you choose to use this official version of Applio (as provided in this repository, without significant modification), you must also comply with our [Terms of Use](./TERMS_OF_USE.md). These terms apply to our integrations, configurations, and default project behavior, and are intended to ensure responsible and ethical use without limiting their use in any way. |
| 36 | +**Inference:** |
| 37 | +```bash |
| 38 | +python rvc_cli.py infer --model_path <path_to_pth> --input_path <audio_file> --output_path <output_file> --index_path <path_to_index> |
| 39 | +``` |
53 | 40 |
|
54 | | -For commercial use, we recommend contacting us at [support@applio.org](mailto:support@applio.org) to ensure your usage aligns with ethical standards. All audio generated with Applio must comply with applicable copyright laws. If you find Applio helpful, consider supporting its development [through a donation](https://ko-fi.com/iahispano). |
| 41 | +**Training:** |
| 42 | +```bash |
| 43 | +python rvc_cli.py train --model_name <name> --total_epoch 100 ... |
| 44 | +``` |
55 | 45 |
|
56 | | -By using the official version of Applio, you accept full responsibility for complying with both the MIT license and our Terms of Use. Applio and its contributors are not liable for misuse. For full legal details, see the [Terms of Use](./TERMS_OF_USE.md). |
| 46 | +**(Add more usage examples as you explore the CLI options)** |
57 | 47 |
|
58 | | -## Getting Started |
| 48 | +## License |
59 | 49 |
|
60 | | -### 1. Installation |
| 50 | +This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. |
61 | 51 |
|
62 | | -Run the installation script based on your operating system: |
| 52 | +## Disclaimer |
63 | 53 |
|
64 | | -- **Windows:** Double-click `run-install.bat`. |
65 | | -- **Linux/macOS:** Execute `run-install.sh`. |
66 | | - |
67 | | -### 2. Running Applio |
68 | | - |
69 | | -Start Applio using: |
70 | | - |
71 | | -- **Windows:** Double-click `run-applio.bat`. |
72 | | -- **Linux/macOS:** Run `run-applio.sh`. |
73 | | - |
74 | | -This launches the Gradio interface in your default browser. |
75 | | - |
76 | | -### 3. Optional: TensorBoard Monitoring |
77 | | - |
78 | | -To monitor training or visualize data: |
79 | | - |
80 | | -- **Windows:** Run `run-tensorboard.bat`. |
81 | | -- **Linux/macOS:** Run `run-tensorboard.sh`. |
82 | | - |
83 | | -For more detailed instructions, visit the [documentation](https://docs.applio.org). |
84 | | - |
85 | | -## References |
86 | | - |
87 | | -Applio is made possible thanks to these projects and their references: |
88 | | - |
89 | | -- [gradio-screen-recorder](https://huggingface.co/spaces/gstaff/gradio-screen-recorder) by gstaff |
90 | | -- [rvc-cli](https://github.com/blaisewf/rvc-cli) by blaisewf |
91 | | - |
92 | | -### Contributors |
93 | | - |
94 | | -<a href="https://github.com/IAHispano/Applio/graphs/contributors" target="_blank"> |
95 | | - <img src="https://contrib.rocks/image?repo=IAHispano/Applio" /> |
96 | | -</a> |
| 54 | +This project is based on the [Applio](https://github.com/IAHispano/Applio) repository but has been stripped down to its core CLI components. All original credits go to the respective authors. |
0 commit comments