🎵 YT-AGENT-AI

📖 Descripción General

YT-AGENT-AI es una aplicación web avanzada que permite traducir y obtener las letras de tus canciones favoritas de YouTube. Utiliza inteligencia artificial para transcribir, formatear y traducir automáticamente las letras de canciones a múltiples idiomas.

✨ Características Principales

• 🎥 YouTube Agent: Descarga video y audio de alta calidad.
• 🎙️ Transcripción con IA: Transcripción de voz a texto de alta precisión usando AssemblyAI.
• 🌍 Soporte Multiidioma: Soporta 11 idiomas con detección automática.
• 🎨 Interfaz Moderna: Interfaz Streamlit para una interacción sencilla.
• 🏗️ Clean Architecture: Construido con separación de responsabilidades y principios SOLID.
• 🐳 Dockerized: Fácil despliegue y desarrollo local.

---

🚀 Inicio Rápido

La forma más fácil de ejecutar la aplicación es usando Docker Compose.

Prerrequisitos

• Docker
• Docker Compose
• OpenAI API Key
• AssemblyAI API Key

Instalación

1. Clonar el repositorio:

   git clone https://github.com/jonma0107/yt-agent-ai.git
   cd Backend

2. Configuración del Entorno:

   Crea un archivo .env en el directorio raíz:

   cp .env.example .env

   Actualiza .env con tus credenciales:

   AAI_API_KEY=tu_api_key_assemblyai
   SECRET_KEY=tu_secret_key_django
   DEBUG=True
   DB_NAME=postgres
   DB_USER=postgres
   DB_PASS=postgres
   DB_HOST=db

3. Ejecutar con Docker Compose:

   docker-compose up --build

   Este comando:

   • Iniciará la base de datos PostgreSQL.
   • Construirá e iniciará el servicio Backend (Django).
   • Construirá e iniciará el servicio Frontend (Streamlit).

4. Acceder a la Aplicación:

   • Frontend (Streamlit): http://localhost:8501
   • Backend API: http://localhost:8000

---

🏗️ Arquitectura

El proyecto sigue un patrón de Clean Architecture. La lógica central está aislada en el directorio translation_generator_app/services.

Para profundizar en la estructura del código, flujo de ejecución y servicios, por favor lee:

👉 Arquitectura Técnica

👉 Componentes Clave y Decisiones Técnicas

---

🌍 Idiomas Soportados

Idioma	Código	Idioma	Código
🇪🇸 Español	es	🇵🇹 Portugués	pt
🇬🇧 Inglés	en	🇷🇺 Ruso	ru
🇫🇷 Francés	fr	🇯🇵 Japonés	ja
🇩🇪 Alemán	de	🇰🇷 Coreano	ko
🇮🇹 Italiano	it	🇨🇳 Chino	zh
-	-	🇸🇦 Árabe	ar

---

Despliegue

La aplicación está contenerizada y lista para despliegue.

• Imagen Docker: Construida automáticamente vía GitHub Actions.
• Producción: Puede desplegarse en plataformas como Render, Railway, o AWS ECS usando el Dockerfile.
• Despliegue del Frontend: Para desplegar la UI, sobrescribe el comando de inicio del contenedor con streamlit run app.py.

---

Licencia

Este proyecto está bajo la Licencia MIT.

---

Desarrollado con ❤️ usando Clean Architecture