{"id":35223704,"url":"https://github.com/esnya/hf-rvc","last_synced_at":"2026-04-02T01:35:43.452Z","repository":{"id":154169544,"uuid":"631616385","full_name":"esnya/hf-rvc","owner":"esnya","description":"Retrieval-based Voice Conversion (RVC) implemented with Hugging Face Transformers.","archived":false,"fork":false,"pushed_at":"2025-05-30T09:02:13.000Z","size":513,"stargazers_count":68,"open_issues_count":4,"forks_count":6,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-10-08T14:52:42.411Z","etag":null,"topics":["rvc","torch","transformers-models","voice-conversion"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/esnya.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-04-23T15:30:51.000Z","updated_at":"2025-08-20T12:17:39.000Z","dependencies_parsed_at":"2024-06-19T03:00:05.827Z","dependency_job_id":"0d9b44d7-f125-4ca3-8060-2cb12e78a73a","html_url":"https://github.com/esnya/hf-rvc","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/esnya/hf-rvc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/esnya%2Fhf-rvc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/esnya%2Fhf-rvc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/esnya%2Fhf-rvc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/esnya%2Fhf-rvc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/esnya","download_url":"https://codeload.github.com/esnya/hf-rvc/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/esnya%2Fhf-rvc/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31293965,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T01:05:07.454Z","status":"ssl_error","status_checked_at":"2026-04-02T00:56:46.496Z","response_time":53,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["rvc","torch","transformers-models","voice-conversion"],"created_at":"2025-12-30T00:59:58.849Z","updated_at":"2026-04-02T01:35:43.448Z","avatar_url":"https://github.com/esnya.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"HF RVC\n----\n\nHF RVC is a package for Retrieval-based-Voice-Conversion (RVC) implementation using HuggingFace's [transformers](https://github.com/huggingface/transformers), along with the capability to convert from original unsafe models. The library is easy to use and provides an efficient way to perform voice conversion tasks.\n\n## Original Implementation\n\nThe original implementation of the Retrieval-based-Voice-Conversion (RVC) can be found at the following GitHub repository: https://github.com/RVC-Project/Retrieval-based-Voice-Conversion-WebUI.\n\n\n## Installation\n\nSupported Python versions: 3.8, 3.9, 3.10 (recommended)\n\nTo install the library, you can use the following command:\n\n```\npip install git+https://github.com/esnya/hf-rvc.git#egg=hf-rvc\n```\n\n\n## Basic Usage\n\nHere's an example of how to use the package as a library:\n\n```python\nfrom hf_rvc import RVCFeatureExtractor, RVCModel\n\nfeature_extractor = RVCFeatureExtractor.from_pretrained(model_name)\n# feature_extractor.set_f0_method(\"harvest\")\n\nmodel = RVCModel.from_pretrained(model_name)\n\ninput_features = feature_extractor(\n    audio[\"array\"],\n    sampling_rate=audio[\"sampling_rate\"],\n    f0_up_key=key,\n    return_tensors=\"pt\",\n)\noutput = model(**input_features).numpy()\n```\n\n\n## Command Line Tools\n\nHF RVC also provides several command line tools. You can check the available commands with --help:\n\n```bash\npython -m hf_rvc --help\n```\n\nFor more detailed usage of each tool, you can check the --help option of the specific command.\n\n### Model Conversion\n\nSince the models are not yet available on HuggingFace, you may need to convert the original `.pth` model files or the original `hubert_base.pt` model to be compatible with HF RVC. This can be done using the `convert-***` command line tools. The conversion not only adapts the models to the different frameworks but also, by default, ensures compatibility with the [safetensor](https://github.com/huggingface/safetensors) format for **secure** model sharing.\n\nWhen using the command line tools to load the `hubert_base.pt` model, you must provide the `--unsafe` option to confirm that you have obtained the model from a trusted source.\nYou also need to install the `fairseq` package to convert the original `.pth` model files. You can install it with this package by with suffix `[convert]`.\n\nExample:\n\n```bash\npython -m hf_rvc convert-rvc --hubert-path \u003cpath_to_hubert_base.pt\u003e --unsafe \u003cpath_to_original_vits_model.pth\u003e\n```\n\n### Real-time Voice Conversion\n\nA real-time voice conversion tool that allows you to perform voice conversion on-the-fly. To use this feature, simply run the following command:\n\n```\npython -m hf_rvc realtime-vc path/to/converted_or_hugging_face/model\n```\n\nThis tool accepts various arguments, including the model, feature extractor, buffering settings, F0 method, input and output device indices, and more. It enables users to adjust the conversion parameters in, offering greater control and customization.\n\n```\npython -m hf_rvc realtime-vc --help\n```\n\nFor a detailed explanation of each argument, please run the `--help` command as shown above.\n\n## Attribution\n\nThe code in `hf_rvc/models/vits` is based on the original implementation published under the MIT License Copyright (c) 2023 liujing04. The code has been slightly modified by esnya.\n\n## Contributing\n\nWe welcome contributions to the package! If you find any issues or have suggestions for improvements, feel free to open an issue or submit a pull request on the GitHub repository.\n\n\n## License\n\nHF RVC is licensed under the [MIT License](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fesnya%2Fhf-rvc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fesnya%2Fhf-rvc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fesnya%2Fhf-rvc/lists"}