CommunityProgramación y desarrollogithub.com

haoyiyin/clone-voice

🎙️ Habilidad para agente — Clonación de voz offline zero-shot con Qwen3-TTS 0.6B. Proporciona un audio de referencia y texto, y obtén voz clonada. CPU/MPS/CUDA, 10 idiomas.

¿Qué es clone-voice?

Este skill permite a los agentes de IA (como Claude Code, Cursor, Codex, etc.) realizar clonación de voz offline sin necesidad de entrenamiento previo (zero-shot). Utiliza el modelo Qwen3-TTS 0.6B para generar habla a partir de un breve audio de referencia (2-5 segundos) y un texto de entrada. Es útil para aplicaciones donde se necesita mantener la identidad de una voz específica sin conexión a internet, como asistentes virtuales, narración personalizada, o doblaje. Soporta múltiples plataformas de hardware (CPU, Apple MPS, NVIDIA CUDA) y 10 idiomas (chino, inglés, japonés, coreano, francés, alemán, español, italiano, portugués, ruso). El flujo de trabajo es simple: el agente recibe una ruta de audio de referencia y un texto, el skill procesa la clonación y devuelve el audio generado. El modelo es compacto (0.6B parámetros), lo que permite ejecución eficiente incluso en hardware modesto.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add haoyiyin/clone-voice

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace clone-voice?

🎙️ Habilidad para agente — Clonación de voz offline zero-shot con Qwen3-TTS 0.6B.

Proporciona un audio de referencia + texto y obtén voz clonada. Compatible con CPU/MPS/CUDA, 10 idiomas.

🔧 Requisitos

  • Python 3.10+
  • PyTorch (con CUDA o MPS según disponibilidad)
  • Espacio en disco: ~1.2 GB (modelo + dependencias)

📦 Instalación

pip install qwen-tts torch torchaudio soundfile

🚀 Uso

Desde línea de comandos

python -m clone_voice --ref_audio ruta/al/audio.wav \
                      --ref_text "texto de referencia" \
                      --gen_text "texto a generar" \
                      --output ruta/salida.wav

Desde Python

import torch
import soundfile as sf
from qwen_tts import QwenTTS

# Cargar modelo (CPU por defecto)
model = QwenTTS.from_pretrained("Qwen/Qwen3-TTS-0.6B")

# Clonar voz
output_wav = model.clone_voice(
    ref_audio="ruta/al/audio.wav",
    ref_text="texto de referencia",
    gen_text="texto a generar",
    device="cpu"  # o "cuda", "mps"
)

# Guardar resultado
sf.write("salida.wav", output_wav, samplerate=24000)

🌍 Idiomas Soportados

IdiomaCódigo
Chinozh
Inglésen
Japonésja
Coreanoko
Francésfr
Alemánde
Españoles
Italianoit
Portuguéspt
Rusoru

⚙️ Configuración Avanzada

  • --device: Seleccionar dispositivo (cpu, cuda, mps). Por defecto: cpu.
  • --speed: Factor de velocidad (0.5-2.0). Por defecto: 1.0.
  • --temperature: Temperatura de muestreo (0.1-1.0). Por defecto: 0.8.

📌 Notas

  • El audio de referencia debe tener al menos 2 segundos de duración y contener voz clara.
  • El texto de referencia debe coincidir con el contenido hablado en el audio de referencia.
  • Para mejor calidad, usa audios con poco ruido de fondo.

📄 Licencia

Apache 2.0

Skills relacionados