Repolode
0x0funky

0x0funky/agent-sprite-forge

Uma skill de agente que transforma uma imagem estática aprovada de um personagem em um conjunto completo de animações 2D prontas para jogos, com frames PNG transparentes e exportações para GIF, WebM, Godot e Aseprite.

Estrelas
5,312
Forks
517
Issues abertas
14
Último commit
há 20 horas

O que é?

Agent Sprite Forge é um conjunto de skills de agente para Claude Code, Codex e Grok que gera sprites 2D para jogos. O fluxo começa com uma imagem estática principal do personagem, que o usuário aprova. Em seguida, o agente cria um clipe de imagem para vídeo para cada ação (idle, walk, run, attack, jump, hurt), e ferramentas determinísticas em Python removem o fundo, alinham os frames, selecionam os loops, ajustam a duração de ações pontuais e empacotam os resultados.

A geração de imagens e vídeos passa por um único script, que usa as chaves de API configuradas para OpenAI, Google Gemini, xAI, BytePlus ou fal.ai, recorre ao CLI do Codex ou Grok com sessão iniciada e, por fim, gera pixel art por código. Cada clipe passa por verificações de qualidade de área, pés, identidade e variação de cores antes de ser aceito.

As saídas incluem animation.json com um atlas PNG, WebM com alpha VP9 e MP4 com alpha empacotado, Godot SpriteFrames e JSON do Aseprite. O projeto também inclui um gerador de mapas que exporta para Tiled, Godot 4 e LDtk.

Recursos principais

  • 01Gera um conjunto completo de ações a partir de uma única imagem estática principal aprovada.
  • 02Remove os fundos com uma máscara suave e alinha os frames para manter estável a escala do corpo.
  • 03Seleciona os loops de walk, run e idle com base em medições e ajusta a duração de ações pontuais.
  • 04Oferece acabamento em HD por padrão e acabamento em pixel art com paleta limitada.
  • 05Exporta animation.json com um atlas PNG, WebM com alpha, MP4 com alpha empacotado e arquivos para Godot e Aseprite.
  • 06Direciona a geração para provedores de API configurados, CLIs locais do Codex ou Grok, ou arte desenhada por código.

Casos de uso

  • Criar animações de personagens para um jogo de plataforma 2D ou de ação a partir de uma única imagem conceitual.
  • Produzir sprite sheets e animações baseadas em frames para projetos Godot ou Aseprite.
  • Prototipar um jogo com personagens, efeitos visuais e mapas baseados em tiles gerados.
  • Criar um jogo para a web que reproduza animações em WebM transparente ou MP4 com alpha empacotado.

Início rápido

  1. 1

    Clone o repositório

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

    Acesse a pasta do projeto

    cd agent-sprite-forge
  3. 3

    Instale as dependências do Python

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

    Instale as skills para o Codex

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

Antes de usar

  • A geração de vídeo requer o ffmpeg 5.1 ou posterior no PATH.
  • A geração de imagens e clipes requer uma chave de API de um provedor pago ou uma sessão iniciada no Codex CLI ou no Grok CLI.

Em coleções

Tópicos

Perguntas frequentes

O que é agent-sprite-forge?
Uma skill de agente que transforma uma imagem estática aprovada de um personagem em um conjunto completo de animações 2D prontas para jogos, com frames PNG transparentes e exportações para GIF, WebM, Godot e Aseprite. Agent Sprite Forge é um conjunto de skills de agente para Claude Code, Codex e Grok que gera sprites 2D para jogos. O fluxo começa com uma imagem estática principal do personagem, que o usuário aprova. Em seguida, o agente cria um clipe de imagem para vídeo para cada ação (idle, walk, run, attack, jump, hurt), e ferramentas determinísticas em Python removem o fundo, alinham os frames, selecionam os loops, ajustam a duração de ações pontuais e empacotam os resultados.
agent-sprite-forge é gratuito? Qual é a licença?
agent-sprite-forge é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
agent-sprite-forge ainda é mantido?
Manutenção ativa. O último commit de agent-sprite-forge foi em 6 de nov. de 2026.
Para que posso usar agent-sprite-forge?
Criar animações de personagens para um jogo de plataforma 2D ou de ação a partir de uma única imagem conceitual. Produzir sprite sheets e animações baseadas em frames para projetos Godot ou Aseprite. Prototipar um jogo com personagens, efeitos visuais e mapas baseados em tiles gerados. Criar um jogo para a web que reproduza animações em WebM transparente ou MP4 com alpha empacotado.
Como instalar agent-sprite-forge?
Clone o repositório: git clone https://github.com/0x0funky/agent-sprite-forge.git Acesse a pasta do projeto: cd agent-sprite-forge Instale as dependências do Python: python -m pip install -r requirements.txt Instale as skills para o Codex: python tools/install_skills.py --apply --host codex
Onde consigo agent-sprite-forge?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/0x0funky/agent-sprite-forge

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados