LibreAI / Imagem / sprite-gen
// image · aldegad/sprite-gen

sprite-gen

sprite-gen é um projeto de imagem de código aberto de aldegad (aldegad/sprite-gen no GitHub). Tem 2.616 estrelas no GitHub e 275 forks, é publicado sob a licença Apache-2.0 e foi atualizado pela última vez no GitHub em 8 de outubro de 2026.

Generate clean 2D game sprites and animation atlases from one drawing — a Codex/Claude skill and Python CLI

★ 2,6 mil estrelas⑂ 275 forksApache-2.0atualizado out 2026
▦ visual: o README deste projeto não inclui nenhuma captura incorporável,
então aqui vai um marcador. O guia abaixo está completo mesmo assim.
// dados do projeto

Dados do projeto

Repositório
aldegad/sprite-gen
Estrelas no GitHub
2.616
Forks
275
Licença
Apache-2.0
Última atualização no GitHub
8 de outubro de 2026
Categoria
Imagem
Tipo de ficha
Guia de instalação completo
// como funciona

Como funciona

  1. Clarify your goal

    Prepare one base image of your character and the list of motion states you need (idle, walk, run, jump, attack...), and choose the atlas pipeline or the video-to-loop pipeline.

  2. Get sprite-gen

    Clone the repo and install it into a fresh virtualenv, or install it as a skill into Codex/Claude.

  3. Install and configure

    Activate the venv, check sprite-gen --help, and connect a generation provider (codex or grok on your existing subscription; the video path uses your own grok login or XAI_API_KEY, plus ffmpeg/img2webp).

  4. Run your first atlas

    sprite-gen prepare your run, gen-set the state rows, extract the frames, and compose-atlas into sprite-sheet-alpha.png + manifest.json.

// recursos

Por que as pessoas gostam tanto

Component-row atlas pipeline

prepare → gen/gen-set → extract → compose-atlas produces a transparent atlas plus a manifest with absolute frame rectangles, per-state fps and loop flags — engines never guess a grid.

Real alpha extraction

Chroma backgrounds are unmixed to true transparency with no leftover fringe, verified against white backgrounds.

Breathe on idle

A still idle pose becomes a living loop with deterministic, anatomy-aware squash-and-stretch baked from a sidecar field.

Video-to-loop pipeline

One still plus a video model yields seamless transparent GIF/WebP/strip loops cut at the clip's true period, with canvas sized per motion (tall for jumps, wide for attacks).

Post-processing tools

Recolor into deterministic colorways, compose rig layers, and export for Aseprite / Phaser / Flame — without regenerating.

Utilities and scenes

Standalone cutout, slice-sheet and unpack-atlas utilities, background tiles, projected shadows, motion inspection, and an optional scene renderer for finished assets.

Advertisement
// execute você mesmo

Execute você mesmo

  1. Clone and install

    Clone sprite-gen and install it into a fresh virtualenv as the quickstart shows (the venv is the only supported interpreter).

    git clone https://github.com/aldegad/sprite-gen.git
    cd sprite-gen
  2. Check the CLI

    Print the command map, grouped by pipeline and tool domain.

    sprite-gen --help
  3. Build an atlas

    Prepare a run from one base image, generate the state rows, extract frames and compose the atlas.

    sprite-gen prepare --out-dir <dir> --character-id <id> --base-image base.png
    sprite-gen gen-set --run-dir <dir> --provider codex
    sprite-gen extract --run-dir <dir>
    sprite-gen compose-atlas --run-dir <dir>
// casos de uso

O que você pode criar

Advertisement
// perguntas frequentes

Perguntas frequentes

Who maintains sprite-gen?

aldegad maintains it; the component-row workflow was inspired by the Apache-2.0 hatch-pet skill, per the README's attribution.

Is it free?

The tool is Apache-2.0 licensed. Generation uses providers on subscriptions you already pay for (codex/grok), an explicit-only OpenAI provider that bills per call, and your own xAI credentials for video.

Does it need a paid API key?

Image generation rides on your existing Codex or Grok subscription by default; the video pipeline needs your own grok login or XAI_API_KEY. Nothing is shipped with the repo.

How does it compare to asking an image model for a sprite sheet directly?

Raw generations drift off-grid, change faces between frames and won't key out cleanly. sprite-gen's pipeline locks identity, extracts real alpha frames and emits an atlas + manifest an engine can consume.

How do I get started?

Clone, create a venv, pip install -e ., then run the prepare → gen-set → extract → compose-atlas flow on one base image.

// continue explorando

Ferramentas semelhantes

Imagem

ai-media-generator

Claude Code skill for cinematic AI image, video and music prompts — 14+ platforms

★ 255 estrelasMIT
Ver o guia →
Imagem

PhotoCraft

PhotoCraft — a clean-room Photoshop reimplementation in pure Rust: layers, masks, adjustment layers, type, vectors, brushes and real PSD files, offline, MIT / Apache-2.0

★ 73,2 mil estrelasMIT / Apache-2.0
Ver o guia →
Imagem

Anime2Sketch

Extract clean line sketches from anime art, illustrations, and manga with a pretrained GAN model.

★ 2,1 mil estrelasMIT
Ver o guia →
Imagem

Janus

DeepSeek's Janus series - unified multimodal models that both understand and generate images

★ 17,8 mil estrelasMIT
Ver o guia →
Imagem

ComfyUI-to-Python-Extension

Turn ComfyUI node workflows into runnable Python scripts you can automate and rerun anywhere.

★ 2,4 mil estrelasMIT
Ver o guia →
// alternativas

Alternativas em Imagem

Os outros projetos de Imagem com mais estrelas no catálogo do LibreAI — a lista realista de alternativas se sprite-gen não for o ideal para você.

// mais em image

Mais em Imagem

Projetos de Imagem próximos no catálogo, os mais próximos em estrelas de sprite-gen: continue explorando dos dois lados dele.

Baixe o sprite-gen

Grátis e aberto: pegue o código-fonte, dê uma estrela no repositório e comece a criar.