infer_rvc_python 1.3.0__tar.gz

infer_rvc_python-1.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Roger Condori
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

infer_rvc_python-1.3.0/PKG-INFO

@@ -0,0 +1,175 @@
+Metadata-Version: 2.1
+Name: infer_rvc_python
+Version: 1.3.0
+Summary: Python wrapper for fast inference with rvc
+Home-page: https://github.com/R3gm/infer_rvc_python
+License: MIT
+Author: R3gm
+Requires-Python: >=3.10,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Provides-Extra: all
+Requires-Dist: edge-tts ; extra == "all"
+Requires-Dist: faiss-cpu (==1.10.0)
+Requires-Dist: ffmpeg-python (>=0.2.0)
+Requires-Dist: librosa
+Requires-Dist: numba (==0.56.4) ; extra == "all"
+Requires-Dist: numpy
+Requires-Dist: praat-parselmouth (>=0.4.2)
+Requires-Dist: pyworld (==0.3.4)
+Requires-Dist: scipy ; extra == "all"
+Requires-Dist: soundfile
+Requires-Dist: soxr (==1.1.0)
+Requires-Dist: torch
+Requires-Dist: torchaudio
+Requires-Dist: torchcrepe (==0.0.20)
+Requires-Dist: torchvision
+Requires-Dist: transformers
+Requires-Dist: typeguard (==4.2.0)
+Project-URL: Repository, https://github.com/R3gm/infer_rvc_python
+Description-Content-Type: text/markdown
+
+# RVC-Python-Fast Inference
+
+A streamlined Python wrapper for fast inference with RVC.
+Specifically designed for inference tasks.
+
+## Introduction
+
+This streamlined wrapper offers an efficient solution for integrating RVC into your Python projects, focusing primarily on rapid inference. Whether you're working on voice conversion applications or related projects, this tool simplifies the process while maintaining performance.
+
+## Key Features
+- Preloaded Models: Accelerate inference by loading models into memory beforehand, minimizing latency during runtime.
+- Batch Processing: Enhance efficiency by enabling batch processing, allowing for simultaneous conversion of multiple inputs, further optimizing throughput.
+- Support for Array Input and Output: Facilitate seamless integration with existing data pipelines by accepting and returning arrays, enhancing compatibility across various platforms and frameworks.
+
+## Getting Started
+
+### Prerequisites
+
+- You need to have ffmpeg and Python installed.
+
+Pre-requirements:
+```
+pip install pip>=24 setuptools<=80.6.0
+```
+
+### Installation
+
+```
+pip install infer_rvc_python
+```
+
+# Usage
+
+## Initialize the base class
+
+```
+from infer_rvc_python import BaseLoader
+
+converter = BaseLoader(only_cpu=False, hubert_path=None, rmvpe_path=None)
+```
+`hubert_path` now accepts a pretrained model instead of a `.pt` file, with `r3gm/hubert_base` as the default value.
+
+
+## Define a tag and select the model along with other parameters.
+
+```
+converter.apply_conf(
+        tag="yoimiya",
+        file_model="model.pth",
+        pitch_algo="rmvpe+",
+        pitch_lvl=0,
+        file_index="model.index",
+        index_influence=0.66,
+        respiration_median_filtering=3,
+        envelope_ratio=0.25,
+        consonant_breath_protection=0.33
+    )
+```
+
+## Select the audio or audios you want to convert.
+
+```
+# audio_files = ["audio.wav", "haha.mp3"]
+audio_files = "myaudio.mp3"
+
+# speakers_list = ["sunshine", "yoimiya"]
+speakers_list = "yoimiya"
+```
+
+## Perform inference
+
+```
+result = converter(
+    audio_files,
+    speakers_list,
+    overwrite=False,
+    parallel_workers=4
+)
+```
+The `result` is a list with the paths of the converted files.
+
+## Unload models
+```
+converter.unload_models()
+```
+
+# Preloading model (Reduces inference time)
+
+The initial execution will preload the model for the tag. Subsequent calls to inference with the same tag will benefit from preloaded components, thereby reducing inference time.
+```
+result_array, sample_rate = converter.generate_from_cache(
+    audio_data="myaudiofile_path.wav",
+    tag="yoimiya",
+)
+```
+
+The param audio_data can be a path or a tuple with (array_data, sampling_rate)
+
+```
+# array_data = np.array([-22, -22, -15, ..., 0, 0, 0], dtype=np.int16)
+# source_sample_rate = 16000
+data = (array_data, source_sample_rate)
+result_array, sample_rate = converter.generate_from_cache(
+    audio_data=data,
+    tag="yoimiya",
+)
+```
+The result in both cases will be (array, sample_rate), which you can save or play in a notebook
+
+```
+# Save
+import soundfile as sf
+
+sf.write(
+    file="output_file.wav",
+    samplerate=sample_rate,
+    data=result_array
+)
+```
+
+```
+# Play; need to install ipython
+from IPython.display import Audio
+
+Audio(result_array, rate=sample_rate)
+```
+When settings or the tag are altered, the model requires reloading. To maintain multiple preloaded models, you can instantiate another BaseLoader object.
+```
+second_converter = BaseLoader()
+```
+# Credits
+- RVC-Project
+- FFMPEG
+
+# License
+This project is licensed under the MIT License.
+
+# Disclaimer
+This software is provided for educational and research purposes only. The authors and contributors of this project do not endorse or encourage any misuse or unethical use of this software. Any use of this software for purposes other than those intended is solely at the user's own risk. The authors and contributors shall not be held responsible for any damages or liabilities arising from the use of this software inappropriately.
+

infer_rvc_python-1.3.0/README.md

@@ -0,0 +1,139 @@
+# RVC-Python-Fast Inference
+
+A streamlined Python wrapper for fast inference with RVC.
+Specifically designed for inference tasks.
+
+## Introduction
+
+This streamlined wrapper offers an efficient solution for integrating RVC into your Python projects, focusing primarily on rapid inference. Whether you're working on voice conversion applications or related projects, this tool simplifies the process while maintaining performance.
+
+## Key Features
+- Preloaded Models: Accelerate inference by loading models into memory beforehand, minimizing latency during runtime.
+- Batch Processing: Enhance efficiency by enabling batch processing, allowing for simultaneous conversion of multiple inputs, further optimizing throughput.
+- Support for Array Input and Output: Facilitate seamless integration with existing data pipelines by accepting and returning arrays, enhancing compatibility across various platforms and frameworks.
+
+## Getting Started
+
+### Prerequisites
+
+- You need to have ffmpeg and Python installed.
+
+Pre-requirements:
+```
+pip install pip>=24 setuptools<=80.6.0
+```
+
+### Installation
+
+```
+pip install infer_rvc_python
+```
+
+# Usage
+
+## Initialize the base class
+
+```
+from infer_rvc_python import BaseLoader
+
+converter = BaseLoader(only_cpu=False, hubert_path=None, rmvpe_path=None)
+```
+`hubert_path` now accepts a pretrained model instead of a `.pt` file, with `r3gm/hubert_base` as the default value.
+
+
+## Define a tag and select the model along with other parameters.
+
+```
+converter.apply_conf(
+        tag="yoimiya",
+        file_model="model.pth",
+        pitch_algo="rmvpe+",
+        pitch_lvl=0,
+        file_index="model.index",
+        index_influence=0.66,
+        respiration_median_filtering=3,
+        envelope_ratio=0.25,
+        consonant_breath_protection=0.33
+    )
+```
+
+## Select the audio or audios you want to convert.
+
+```
+# audio_files = ["audio.wav", "haha.mp3"]
+audio_files = "myaudio.mp3"
+
+# speakers_list = ["sunshine", "yoimiya"]
+speakers_list = "yoimiya"
+```
+
+## Perform inference
+
+```
+result = converter(
+    audio_files,
+    speakers_list,
+    overwrite=False,
+    parallel_workers=4
+)
+```
+The `result` is a list with the paths of the converted files.
+
+## Unload models
+```
+converter.unload_models()
+```
+
+# Preloading model (Reduces inference time)
+
+The initial execution will preload the model for the tag. Subsequent calls to inference with the same tag will benefit from preloaded components, thereby reducing inference time.
+```
+result_array, sample_rate = converter.generate_from_cache(
+    audio_data="myaudiofile_path.wav",
+    tag="yoimiya",
+)
+```
+
+The param audio_data can be a path or a tuple with (array_data, sampling_rate)
+
+```
+# array_data = np.array([-22, -22, -15, ..., 0, 0, 0], dtype=np.int16)
+# source_sample_rate = 16000
+data = (array_data, source_sample_rate)
+result_array, sample_rate = converter.generate_from_cache(
+    audio_data=data,
+    tag="yoimiya",
+)
+```
+The result in both cases will be (array, sample_rate), which you can save or play in a notebook
+
+```
+# Save
+import soundfile as sf
+
+sf.write(
+    file="output_file.wav",
+    samplerate=sample_rate,
+    data=result_array
+)
+```
+
+```
+# Play; need to install ipython
+from IPython.display import Audio
+
+Audio(result_array, rate=sample_rate)
+```
+When settings or the tag are altered, the model requires reloading. To maintain multiple preloaded models, you can instantiate another BaseLoader object.
+```
+second_converter = BaseLoader()
+```
+# Credits
+- RVC-Project
+- FFMPEG
+
+# License
+This project is licensed under the MIT License.
+
+# Disclaimer
+This software is provided for educational and research purposes only. The authors and contributors of this project do not endorse or encourage any misuse or unethical use of this software. Any use of this software for purposes other than those intended is solely at the user's own risk. The authors and contributors shall not be held responsible for any damages or liabilities arising from the use of this software inappropriately.

infer_rvc_python-1.3.0/infer_rvc_python/__init__.py

@@ -0,0 +1 @@
+from .main import BaseLoader

infer_rvc_python-1.3.0/infer_rvc_python/lib/audio.py

@@ -0,0 +1,21 @@
+import ffmpeg
+import numpy as np
+
+
+def load_audio(file, sr):
+    try:
+        # https://github.com/openai/whisper/blob/main/whisper/audio.py#L26
+        # This launches a subprocess to decode audio while down-mixing and resampling as necessary.
+        # Requires the ffmpeg CLI and `ffmpeg-python` package to be installed.
+        file = (
+            file.strip(" ").strip('"').strip("\n").strip('"').strip(" ")
+        )  # To prevent beginners from copying paths with leading or trailing spaces, quotation marks, and line breaks.
+        out, _ = (
+            ffmpeg.input(file, threads=0)
+            .output("-", format="f32le", acodec="pcm_f32le", ac=1, ar=sr)
+            .run(cmd=["ffmpeg", "-nostdin"], capture_stdout=True, capture_stderr=True)
+        )
+    except Exception as e:
+        raise RuntimeError(f"Failed to load audio: {e}")
+
+    return np.frombuffer(out, np.float32).flatten()