aldegad/sprite-gen

O que é?

Recursos principais

• 01Gera estados de sprite linha por linha a partir de uma única imagem base, mantendo o personagem consistente.
• 02Converte fundos de chroma key em transparência alpha real e extrai quadros transparentes limpos.
• 03Gera um atlas pronto para uso em runtime com um `manifest.json` que lista os retângulos dos quadros, o fps e as flags de loop.
• 04Cria loops de animação transparentes com modelos de vídeo, um para cada estado de movimento.
• 05Oferece uma webview de curadoria para revisar, ajustar e pré-visualizar os quadros antes de gerar os assets.
• 06Inclui recoloração e exportação em JSON do Aseprite para engines como Phaser e Flame.

Casos de uso

• Transformar uma única ilustração de personagem em um conjunto completo de sprites de idle, caminhada, ataque e pulo para um jogo 2D.
• Gerar animações transparentes em loop a partir de uma imagem estática usando um modelo de vídeo.
• Recolorir uma sprite sheet existente para criar várias versões de paleta.
• Exportar atlas de sprites para Phaser ou Flame usando JSON do Aseprite.

Início rápido

1. 1

   Crie e ative um ambiente virtual do Python

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

   Instale o sprite-gen em modo editável

   pip install -e .
3. 3

   Verifique se a CLI é executada

   sprite-gen --help

Antes de usar

• !Para gerar imagens e vídeos, é necessário fazer login com uma assinatura do Codex ou do Grok, ou usar uma chave de API como XAI_API_KEY.
• !Para criar loops de vídeo, também é necessário instalar o ffmpeg e o img2webp separadamente.
• !Os loops de caminhada e corrida são experimentais se não forem aprovados no controle de qualidade de movimento (motion QA); a correção de direção é opcional e pode estar errada.

Em coleções

Tópicos

Perguntas frequentes

O que é sprite-gen?

Skill para Codex/Claude e CLI em Python que transforma uma imagem base em atlas de sprites 2D prontos para jogos ou loops de animação com transparência. O sprite-gen resolve um problema comum dos modelos de geração de imagens por IA: ao pedir uma sprite sheet, geralmente o personagem muda de aparência entre os quadros, o fundo não é removido de forma limpa e os PNGs não podem ser usados diretamente pelas engines de jogos. A ferramenta parte de uma única imagem base, gera cada estado da animação linha por linha mantendo o personagem consistente, remove o fundo de chroma key e cria transparência alpha real, além de extrair cada pose como um quadro transparente.

sprite-gen é gratuito? Qual é a licença?

sprite-gen é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.

sprite-gen ainda é mantido?

Manutenção ativa. O último commit de sprite-gen foi em 6 de nov. de 2026.

Para que posso usar sprite-gen?

Transformar uma única ilustração de personagem em um conjunto completo de sprites de idle, caminhada, ataque e pulo para um jogo 2D. Gerar animações transparentes em loop a partir de uma imagem estática usando um modelo de vídeo. Recolorir uma sprite sheet existente para criar várias versões de paleta. Exportar atlas de sprites para Phaser ou Flame usando JSON do Aseprite.

Como instalar sprite-gen?

Crie e ative um ambiente virtual do Python: python3 -m venv .venv && source .venv/bin/activate Instale o sprite-gen em modo editável: pip install -e . Verifique se a CLI é executada: sprite-gen --help

Onde consigo sprite-gen?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/aldegad/sprite-gen