Repolode
0x0funky

0x0funky/agent-sprite-forge

Una skill de agente que convierte una imagen fija aprobada de un personaje en un conjunto completo de animaciones 2D listas para juegos, con fotogramas PNG transparentes y exportaciones GIF/WebM/Godot/Aseprite.

Estrellas
5,360
Forks
520
Issues abiertos
14
Último commit
ayer

¿Qué es?

Agent Sprite Forge es un conjunto de skills de agente para Claude Code, Codex y Grok que genera sprites 2D para juegos. El flujo de trabajo parte de una imagen fija maestra del personaje, que el usuario aprueba. Después, el agente genera un clip de imagen a video por cada acción (idle, walk, run, attack, jump, hurt), y unas herramientas deterministas de Python eliminan el fondo, alinean los fotogramas, seleccionan los bucles, ajustan la duración de las acciones de una sola ejecución y empaquetan los resultados.

La generación de imágenes y videos se gestiona mediante un único script que usa las claves de API configuradas para OpenAI, Google Gemini, xAI, BytePlus o fal.ai; si no están disponibles, recurre a una CLI de Codex o Grok con sesión iniciada y, como última opción, a pixel art dibujado mediante código. Cada clip debe superar controles de calidad de área, pies, identidad y variación de color antes de aceptarse.

Los resultados incluyen animation.json con un atlas PNG, WebM VP9 con alfa y MP4 con alfa empaquetado, SpriteFrames de Godot y JSON de Aseprite. El proyecto también incluye un generador de mapas que exporta a Tiled, Godot 4 y LDtk.

Funciones clave

  • 01Genera un conjunto completo de acciones a partir de una única imagen fija maestra aprobada.
  • 02Elimina los fondos con una máscara suave y alinea los fotogramas para mantener estable la escala del cuerpo.
  • 03Selecciona los bucles de walk, run e idle mediante mediciones y ajusta la duración de las acciones de una sola ejecución.
  • 04Ofrece por defecto un acabado HD y una opción de pixel art con paleta limitada.
  • 05Exporta animation.json con un atlas PNG, WebM con alfa, MP4 con alfa empaquetado y archivos de Godot y Aseprite.
  • 06Gestiona la generación mediante proveedores de API configurados, las CLI locales de Codex o Grok, o arte dibujado mediante código.

Casos de uso

  • Crear animaciones de personajes para un juego de plataformas 2D o de acción a partir de una sola imagen conceptual.
  • Generar hojas de sprites y animaciones basadas en fotogramas para proyectos de Godot o Aseprite.
  • Crear prototipos de juegos con personajes y efectos generados, además de mapas basados en mosaicos.
  • Desarrollar un juego web que reproduzca animaciones WebM transparentes o MP4 con alfa empaquetado.

Inicio rápido

  1. 1

    Clona el repositorio

    git clone https://github.com/0x0funky/agent-sprite-forge.git
  2. 2

    Entra en la carpeta del proyecto

    cd agent-sprite-forge
  3. 3

    Instala las dependencias de Python

    python -m pip install -r requirements.txt
  4. 4

    Instala las skills para Codex

    python tools/install_skills.py --apply --host codex

Antes de usarlo

  • La generación de vídeo requiere ffmpeg 5.1 o posterior en PATH.
  • La generación de imágenes y clips requiere una clave API de un proveedor de pago o una sesión iniciada en Codex CLI o Grok CLI.

En colecciones

Temas

Preguntas frecuentes

¿Qué es agent-sprite-forge?
Una skill de agente que convierte una imagen fija aprobada de un personaje en un conjunto completo de animaciones 2D listas para juegos, con fotogramas PNG transparentes y exportaciones GIF/WebM/Godot/Aseprite. Agent Sprite Forge es un conjunto de skills de agente para Claude Code, Codex y Grok que genera sprites 2D para juegos. El flujo de trabajo parte de una imagen fija maestra del personaje, que el usuario aprueba. Después, el agente genera un clip de imagen a video por cada acción (idle, walk, run, attack, jump, hurt), y unas herramientas deterministas de Python eliminan el fondo, alinean los fotogramas, seleccionan los bucles, ajustan la duración de las acciones de una sola ejecución y empaquetan los resultados.
¿agent-sprite-forge es gratuito? ¿Qué licencia tiene?
agent-sprite-forge es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿agent-sprite-forge sigue mantenido?
Mantenimiento activo. El último commit de agent-sprite-forge fue el 6 nov 2026.
¿Para qué puedo usar agent-sprite-forge?
Crear animaciones de personajes para un juego de plataformas 2D o de acción a partir de una sola imagen conceptual. Generar hojas de sprites y animaciones basadas en fotogramas para proyectos de Godot o Aseprite. Crear prototipos de juegos con personajes y efectos generados, además de mapas basados en mosaicos. Desarrollar un juego web que reproduzca animaciones WebM transparentes o MP4 con alfa empaquetado.
¿Cómo se instala agent-sprite-forge?
Clona el repositorio: git clone https://github.com/0x0funky/agent-sprite-forge.git Entra en la carpeta del proyecto: cd agent-sprite-forge Instala las dependencias de Python: python -m pip install -r requirements.txt Instala las skills para Codex: python tools/install_skills.py --apply --host codex
¿Dónde consigo agent-sprite-forge?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/0x0funky/agent-sprite-forge

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados