README.md

Reference Voice Conversion (HF Space)

Convert any vocal to match a reference voice (tone color) with [OpenVoice v2] and optional vocal separation via [Demucs]. Built with Gradio for fast UX.

✨ Features

• Upload Reference (clean 5–20 seconds) and Track or Acapella
• Optional Demucs stem separation to extract vocals from full mix
• Control style strength, pitch, formant tilt
• Remix converted vocal with instrumental and gain controls

🚀 Deploy

1. Create a new Hugging Face Space (Python + Gradio). Hardware: GPU recommended.
2. Add these files (app.py, requirements.txt, README.md).
3. (Optional) Add spaces.yml:

sdk: gradio
python_version: 3.10
resources:
  accelerators: ["gpu"]
Commit & run. First build downloads models (~hundreds MB).
🧪 Tips
Reference should be clean, dry (no heavy FX), mono is fine.
Better results