Metadata-Version: 2.5
Name: sikandarmoyaldev-rvc
Version: 0.0.3
Summary: Lightweight, WebUI-free RVC inference and training engine
Project-URL: Homepage, https://github.com/sikandarmoyaldev/python-rvc
Project-URL: Repository, https://github.com/sikandarmoyaldev/python-rvc
Author-email: Sikandar <sikandar.moyal.dev@gmail.com>
License: MIT
Requires-Python: >=3.12
Requires-Dist: einops>=0.8.2
Requires-Dist: faiss-cpu>=1.15.0
Requires-Dist: ffmpeg-python>=0.2.0
Requires-Dist: huggingface-hub>=1.27.0
Requires-Dist: librosa>=0.11.0
Requires-Dist: local-attention>=1.11.2
Requires-Dist: numpy>=2.4.6
Requires-Dist: praat-parselmouth>=0.4.7
Requires-Dist: pyworld>=0.3.5
Requires-Dist: scipy>=1.17.1
Requires-Dist: soundfile>=0.14.0
Requires-Dist: torch>=2.13.0
Requires-Dist: torchaudio>=2.11.0
Requires-Dist: torchfcpe>=0.0.4
Requires-Dist: transformers>=5.15.0
Description-Content-Type: text/markdown

# sikandarmoyaldev-rvc

Lightweight, WebUI-free RVC (Retrieval-based Voice Conversion) inference engine for the python project.

## 📦 Installation

```bash
pip install sikandarmoyaldev-rvc
# or
pip install git+https://github.com/sikandarmoyaldev/python-rvc.git
```

## 📖 Usage

### 1. Download Base Models

Before converting, you must download the required base models (`HuBERT`, `RMVPE`, etc.).

```python
from rvc import download_base_models

download_base_models("assets")
```

### 2. Convert Audio

Initialize the converter with your custom `.pth` model and convert your audio files.

```python
from rvc import RVCConverter

# Initialize with your model path and assets directory
converter = RVCConverter(model_path="alex.pth", assets_dir="assets")

# Convert a single file (output defaults to "output/input_filename.wav")
output_file = converter.convert(
    input_path="group-1.wav", pitch=2, f0_method="rmvpe", index_rate=0.0
)

print(f"Saved to: {output_file}")
```

## 🚀 Development

This project uses `uv` for dependency management.

```bash
# Install dependencies
uv sync

# Format and lint code
uv run ruff format .
uv run ruff check . --fix
```
