Arquitectura y requisitos
Entiende el recorrido completo del video, audio, IA y eventos antes de instalar los programas.
¿Qué vas a construir?
Una streamer virtual llamada Luna que aparece en una escena vertical, habla en español, genera respuestas locales con IA y reacciona a ciertos eventos del directo. Este tutorial sigue exactamente la arquitectura del ZIP, no propone un sistema distinto.
El proyecto combina dos caminos diferentes: imagen (VRoid → VNyan → OBS → LIVE Studio) y automatización (TikFinity → Node → Ollama/Piper/VNyan). La voz debe configurarse por separado: la cámara virtual de OBS no transmite el audio por sí misma.
Requisitos mínimos y recomendaciones
- Windows 10/11 de 64 bits; el código de reproducción WAV utiliza SoundPlayer y PowerShell.
- Node.js 22.4 o superior; usa la edición LTS desde el sitio oficial.
- Python de 64 bits compatible con piper-tts, Ollama instalado y espacio para el modelo.
- VRoid Studio, VNyan, OBS Studio, TikFinity Desktop y TikTok LIVE Studio cuando tu cuenta tenga acceso.
- 32 GB de RAM deseables para combinar aplicaciones; en una GPU integrada prioriza 720 × 1280 a 30 FPS.
- Conexión estable y autorización de TikTok LIVE en la región y la cuenta.
Puertos y funciones que debes conocer
| Componente | Dirección local | Para qué sirve |
|---|---|---|
| Ollama | http://127.0.0.1:11434 | Respuestas de IA. |
| VNyan API | http://127.0.0.1:8069/ | Acciones con API Message. |
| TikFinity Desktop | ws://127.0.0.1:21213/ | Recibe eventos del LIVE. |
| Overlay Node | http://127.0.0.1:8787/ | Textos y subtítulos para OBS. |
Todos estos servicios están pensados para localhost, no para exposición pública. En Windows, comprueba cada uno en ese mismo equipo antes de introducir TikTok en el flujo.
Qué muestran tus capturas
Las imágenes corresponden a una instalación con VRoid Studio 2.14.0, VNyan v1.7.3e y OBS 29.0.2. La interfaz de TikTok LIVE Studio y TikFinity también aparece en las capturas. Las versiones actuales pueden disponer los menús de manera diferente.
En los próximos capítulos encontrarás una explicación de cada pantalla, enlaces de descarga, rutas locales, bloques de código copiables y comprobaciones.