aldegad/sprite-gen

¿Qué es?

Funciones clave

• 01Genera los estados de los sprites fila por fila a partir de una imagen base y mantiene la coherencia del personaje.
• 02Convierte fondos de chroma key en un canal alpha real y extrae fotogramas transparentes limpios.
• 03Genera un atlas listo para usar en tiempo de ejecución, con un `manifest.json` que enumera los rectángulos de los fotogramas, los fps y los indicadores de bucle.
• 04Crea bucles de animación transparentes con modelos de video, uno por cada estado de movimiento.
• 05Ofrece una vista web de selección para revisar, ajustar y previsualizar los fotogramas antes de generar los recursos finales.
• 06Incluye cambio de color y exportación a JSON de Aseprite para motores como Phaser y Flame.

Casos de uso

• Convertir la ilustración de un personaje en un conjunto completo de sprites de reposo, caminata, ataque y salto para un juego 2D.
• Generar animaciones transparentes en bucle a partir de una imagen estática con un modelo de video.
• Cambiar los colores de una hoja de sprites existente para crear varias variantes de paleta.
• Exportar atlas de sprites a Phaser o Flame mediante JSON de Aseprite.

Inicio rápido

1. 1

   Crea y activa un entorno virtual de Python

   python3 -m venv .venv && source .venv/bin/activate
2. 2

   Instala sprite-gen en modo editable

   pip install -e .
3. 3

   Comprueba que se ejecuta la CLI

   sprite-gen --help

Antes de usarlo

• !Para generar imágenes y vídeos, necesitas iniciar sesión con una suscripción a Codex o Grok, o usar una clave de API como XAI_API_KEY.
• !Para crear bucles de vídeo, también debes instalar ffmpeg e img2webp por separado.
• !Los bucles de caminar y correr son experimentales si no superan el control de calidad del movimiento (motion QA); la corrección de dirección es opcional y puede fallar.

En colecciones

Temas

Preguntas frecuentes

¿Qué es sprite-gen?

Skill de Codex/Claude y CLI de Python que convierte una imagen base en atlas de sprites 2D listos para juegos o animaciones transparentes en bucle. sprite-gen resuelve un problema frecuente de los modelos de generación de imágenes con IA: al pedirles una hoja de sprites, suelen generar un personaje cuyo aspecto cambia entre fotogramas, fondos difíciles de eliminar con chroma key y archivos PNG que los motores de juegos no pueden usar directamente. La herramienta parte de una sola imagen base, genera cada estado de animación fila por fila manteniendo la coherencia del personaje, elimina el fondo de chroma key para crear un canal alpha real y extrae cada pose como un fotograma transparente.

¿sprite-gen es gratuito? ¿Qué licencia tiene?

sprite-gen es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.

¿sprite-gen sigue mantenido?

Mantenimiento activo. El último commit de sprite-gen fue el 6 nov 2026.

¿Para qué puedo usar sprite-gen?

Convertir la ilustración de un personaje en un conjunto completo de sprites de reposo, caminata, ataque y salto para un juego 2D. Generar animaciones transparentes en bucle a partir de una imagen estática con un modelo de video. Cambiar los colores de una hoja de sprites existente para crear varias variantes de paleta. Exportar atlas de sprites a Phaser o Flame mediante JSON de Aseprite.

¿Cómo se instala sprite-gen?

Crea y activa un entorno virtual de Python: python3 -m venv .venv && source .venv/bin/activate Instala sprite-gen en modo editable: pip install -e . Comprueba que se ejecuta la CLI: sprite-gen --help

¿Dónde consigo sprite-gen?

El código fuente y las instrucciones de instalación están en GitHub: https://github.com/aldegad/sprite-gen