SUN-to-Spotify

Sun to Spotify: Revoluciona tu Consumo de Información con Podcasts Generados por IA

En la era de la sobrecarga de información, Sun to Spotify surge como la solución definitiva para transformar la manera en que consumimos contenido. Esta innovadora herramienta permite convertir cualquier tema, pregunta o feed de datos en un podcast de diálogo completo, listo para ser escuchado en Spotify o en tu aplicación de podcasts favorita.

Ya sea que necesites un resumen de las últimas noticias sobre inteligencia artificial o un análisis profundo sobre estrategias de marketing, Sun to Spotify se encarga de todo el proceso de producción, permitiéndote aprender mientras viajas, haces ejercicio o realizas otras actividades.

¿Qué es Sun to Spotify?

Sun to Spotify es una plataforma y un conjunto de herramientas de código abierto diseñadas para automatizar la creación de contenido de audio de alta calidad. A diferencia de los simples generadores de texto a voz, Sun gestiona el flujo de trabajo completo de producción de un podcast:

1. Investigación: Analiza el tema o la pregunta proporcionada.
2. Escritura del guion: Crea un guion estructurado para un diálogo entre varios locutores.
3. Diálogo multi-voz: Genera audio utilizando diferentes voces para simular una conversación natural.
4. Mezcla de audio: Combina las voces y elementos sonoros para un acabado profesional.
5. Publicación: Envía el resultado directamente a tu biblioteca de Spotify.

El núcleo de esta tecnología es la sun-cli, una interfaz de línea de comandos que permite a los usuarios y a agentes de IA como Claude Code interactuar con la API de Sun de manera eficiente.

Características Principales de Sun to Spotify

El sistema de Sun to Spotify está repleto de funciones avanzadas diseñadas para ofrecer flexibilidad y calidad profesional en cada episodio generado:

• Generación Basada en Prompts: Solo necesitas proporcionar una instrucción en lenguaje natural para iniciar la creación.
• Duración Personalizable: Puedes definir la duración de tu podcast, desde breves resúmenes de 5 minutos hasta inmersiones profundas de 120 minutos.
• Integración con Spotify: Los podcasts generados aterrizan directamente en tu cuenta de Spotify, facilitando el acceso desde cualquier dispositivo vinculado.
• Soporte Multi-locutor: La IA utiliza múltiples voces para crear una experiencia de diálogo dinámica y atractiva.
• CLI Potente (sun-cli): Una herramienta de línea de comandos robusta que permite gestionar inicios de sesión, creación de audio, estados de trabajo y descargas.
• Compatibilidad con Claude Code: Un skill específico permite que Claude Code maneje la CLI de Sun por ti.
• Modo JSON: Todos los comandos soportan salida en formato JSON, lo que facilita la automatización mediante scripts.
• Descargas Parciales: Con el flag --partial, puedes empezar a descargar y escuchar segmentos del podcast incluso antes de que la generación total haya finalizado.
• Gestión de Tokens de API: Permite crear y revocar tokens personales para usos en entornos de CI o despliegues sin interfaz (headless).

Casos de Uso de Sun to Spotify

La versatilidad de Sun to Spotify permite aplicarlo en numerosos escenarios cotidianos y profesionales:

• Resúmenes de Noticias Tecnológicas: Puedes pedir: "¿Qué es lo último en IA de voz y audio? Dame un resumen de 10 minutos".
• Informes Financieros: Obtén actualizaciones matutinas del mercado de valores en un formato de audio de 5 minutos mientras tomas tu café.
• Productividad Personal: Sincroniza tu calendario y pide un resumen de tus próximas reuniones para los siguientes 30 minutos.
• Educación y Literatura: Transforma libros complejos en podcasts educativos. Por ejemplo: "Resume 'The Hard Thing About Hard Things' como un podcast de 20 minutos".
• Consultoría Estratégica: Profundiza en temas de negocios específicos como: "¿Cómo debería pensar en el marketing de mi startup B2B? Dame una inmersión profunda de 15 minutos".

Cómo Usar Sun to Spotify

Para comenzar a disfrutar de tus propios podcasts personalizados, sigue estos pasos detallados basados en la documentación oficial.

1. Instalación de la CLI

Primero, debes instalar la interfaz de línea de comandos (sun-cli). Se requiere Python 3.10+. Puedes solicitar a tu agente que lo instale automáticamente o hacerlo manualmente con el siguiente comando:

curl -fsSL https://sunapp-ai.github.io/sun-to-spotify/install.sh | bash

El instalador detectará tu gestor de paquetes (priorizando uv, luego pipx y finalmente pip). También puedes realizar una instalación manual específica:

• Usando uv: uv tool install 'sun-cli>=0.2.1'
• Usando pipx: pipx install 'sun-cli>=0.2.1'
• Usando pip: pip install 'sun-cli>=0.2.1'

2. Instalación del Skill para Claude Code

Si utilizas Claude Code, puedes enseñarle a manejar la CLI clonando el repositorio del skill en tu directorio de skills de Claude:

# Para uso exclusivo en un repositorio específico
git clone https://github.com/sunapp-ai/sun-to-spotify .claude/skills/sun-to-spotify

# Para uso global en todos tus proyectos
git clone https://github.com/sunapp-ai/sun-to-spotify ~/.claude/skills/sun-to-spotify

3. Autenticación

Ejecuta el comando de inicio de sesión para vincular tu cuenta:

sun login

Esto abrirá tu navegador para que inicies sesión o crees una cuenta gratuita. Las credenciales se almacenan localmente y los tokens se refrescan automáticamente. Para verificar tu sesión, usa sun whoami.

4. Generación de Contenido

Una vez autenticado, puedes solicitar cualquier podcast. El comando base para la creación de audio es:

sun audio create --prompt "Tu tema aquí" --duration-minutes 15

Flags importantes de sun audio create:

• --prompt: El tema a generar (hasta 4000 caracteres).
• --input: Lee el prompt desde un archivo.
• --duration-minutes: Duración deseada (entre 5 y 120 minutos).
• --wait: Bloquea la terminal hasta que el trabajo termine.

5. Guardar en Spotify

Una vez que la generación finaliza, puedes usar el skill save-to-spotify o la CLI correspondiente para subir el audio producido a tu biblioteca de Spotify, incluyendo elementos como arte de portada y líneas de tiempo en el reproductor.

Referencia de Comandos CLI

| Comando | Función | | :--- | :--- | | sun login | Iniciar sesión mediante el navegador. | | sun tokens create <name> | Crear un token de API personal. | | sun audio status <id> | Verificar el estado (PENDING, PROCESSING, SUCCESS, ERROR). | | sun audio get <id> | Descargar el audio finalizado o el manifiesto JSON. | | sun logout | Cerrar sesión y eliminar credenciales locales. |

Preguntas Frecuentes (FAQ)

¿Qué requisitos técnicos necesito? Es necesario tener instalado Python 3.10 o superior para ejecutar la sun-cli.

¿Cómo puedo usar Sun to Spotify en entornos de CI o servidores sin interfaz? Debes generar un token de API personal con sun tokens create <name> y configurar la variable de entorno SUN_TOKEN en tu servidor.

¿Puedo descargar el audio mientras se está generando? Sí, utilizando el comando sun audio get <JOB_ID> --partial --out ./dir, la herramienta descargará los episodios a medida que se vayan completando.

¿Qué significan los códigos de error comunes?

• 401 (unauthorized): Token inválido o ausente.
• 404 (not_found): ID de recurso incorrecto.
• 429 (rate_limit_exceeded): Se ha excedido el límite de velocidad de peticiones.
• 500 (internal_error): Error del servidor; se recomienda reintentar con una espera exponencial.

¿Es compatible con versiones antiguas? El comando sun courses funciona como un alias oculto por compatibilidad con versiones anteriores, pero muestra una advertencia de depreciación. Se recomienda migrar a sun audio.