Mindket

sprite-gen

Newversion 1 · updated
Star4097

Overview

Turns one base drawing of a character into game-ready sprites, either an atlas with a manifest or transparent motion loops, for game developers working in Codex or Claude Code.

sprite-gen is an open-source project on GitHub in the Developer category, listed by Mindket. It is free. This is version 1, last updated on . Install it from GitHub as its README says. Get Mindket’s setup notes on your Mindket account, as a zip.

At a glance

Runs in
  • Codex, as a skill
  • Claude Code, as a skill
  • A terminal, through the Python command line tool
  • A browser, for the optional curation view

Platform

CodexCoding agent
Claude CodeCoding agent

About

What it is

sprite-gen is a skill for Codex and Claude, plus a Python command line tool, that turns one base image of a character into game assets. It either bakes a sprite atlas with a machine readable manifest or returns a clean transparent loop for each motion state. It exists because image models asked for a sprite sheet tend to shift faces between frames and leave backdrops that resist removal.

Who it suits

Indie developers, pixel artists and small studios that need animated 2D characters without drawing every frame by hand. You start from a single still, and the agent runs the steps.

IndustryWho uses itHow they use itExample
Game developmentIndie developersTurn one character drawing into a runtime sprite atlasA paladin, wolf or slime made from a single still
Pixel artArtistsMake new colourways of a finished sheetA recolored version of a character sheet
Game artAnimatorsProduce transparent attack loops from one stillAn attack loop for a hooded fox or a slime
Scene buildingDevelopersCompose a scene from finished assetsA village with layered scenery and projected shadows

Skip it if you want fully hand drawn animation, since it relies on generation and a curation step for the final touches.

Where to use it

It runs through your agent and a terminal.

  • Codex, as a skill
  • Claude Code, as a skill
  • A terminal, through the Python command line tool
  • A browser, for the optional curation view
  • Aseprite, Phaser and Flame, through the export step
Use caseWhoWhat they get back
Animate one character as an atlasGame developerA transparent sprite sheet plus a manifest with its frame layout
Make a motion loop for a stateGame artistA looping transparent GIF, WebP or strip for that state
Recolor a finished sheetPixel artistDeterministic colourways of the sheet
Build a scene from finished assetsDeveloperA rendered scene from your assets and a scene file

How to use it

Ask your agent for sprites or for an image. It checks access, asks only about the provider and motion choices you have not given, runs the pipeline and delivers the files. The curation view is optional. You can save your choices once as separate defaults for sprites and for images, and a one time request does not overwrite them.

The help command prints a map of the pipelines and groups commands by the part of the code that owns them.

sprite-gen --help

For side view sprites, the facing option takes right or left and is used for both canvas placement and clip prompts. To ask for an orientation in the generation prompt, give a reference image with the facing option.

gen --ref image.png --facing right
ToolWhat it does
A, atlas rows (prepare, gen, extract, compose-atlas)Takes one still and a list of states and returns a sprite sheet with transparency and a manifest
B, video to loop (video-canvas, video, video-frames, video-loop)Animates the still with the Grok video model and returns a transparent GIF, WebP or strip per state
C, utilities (cutout, slice-sheet, unpack-atlas)Cleans an imported image or grid sheet, or turns a finished atlas into a run you can curate
D, post-processing (recolor, export-)Makes colourways of a finished sheet and exports for Aseprite, Phaser and Flame
E, asset tools (background-tile, shadow, inspect-motion)Independent commands for backgrounds, shadows and checking motion
S, scene (scene-render, scene-inspect)Renders and inspects a scene from existing assets and a scene file

Example

You give your agent one still of a slime and ask for an attack loop. The video pipeline animates it with the Grok video model, checks the frames, picks the loop automatically and returns a transparent loop with no manual cut points.

For newcomers and experts

If you are new to this, think of it as a production line for one character. A first small try is to ask your agent for sprites from a single drawing and skip the curation view. You get a transparent sheet and a manifest your game engine can read.

If you know the field, the atlas path generates row by row, locks the character's identity, converts the chroma background to real alpha and extracts each pose as its own frame. The video path cuts clips at their true period so loops repeat cleanly. The facing detector only notes its guess unless told otherwise, and a confident guess can still be mistaken. Mirror and regenerate fixes are opt in, and prompts can request a direction but cannot guarantee it.

  1. Give one base image of the character
  2. Generate poses row by row
  3. Strip the background to real transparency
  4. Extract each pose as a clean frame
  5. Bake the atlas and its manifest

Good to know

  • It needs access to an image or video provider, and the agent checks that before it starts.
  • Orientation is only requested in prompts. Fix options such as the mirror option exist, but you should review the still before using them.
  • The facing detector is record only unless you turn a fix on, and its guess can be wrong.
  • An optional curation view shows frames side by side so you can drop or shift them, and play the loop before baking.
  • The license is Apache-2.0.
  • Each pipeline has its own page in the docs folder.

README and files

README
# sprite-gen

Turns one base drawing of a character into game-ready sprites, either an atlas with a manifest or transparent motion loops, for game developers working in Codex or Claude Code.

Made by aldegad on GitHub. These notes are Mindket's, written from its README; the project's own files and license are in its repository.

## About

What it is: sprite-gen is a skill for Codex and Claude, plus a Python command line tool, that turns one base image of a character into game assets. It either bakes a sprite atlas with a machine readable manifest or returns a clean transparent loop for each motion state. It exists because image models asked for a sprite sheet tend to shift faces between frames and leave backdrops that resist removal.

Who it suits: Indie developers, pixel artists and small studios that need animated 2D characters without drawing every frame by hand. You start from a single still, and the agent runs the steps.

```table
Industry | Who uses it | How they use it | Example
Game development | Indie developers | Turn one character drawing into a runtime sprite atlas | A paladin, wolf or slime made from a single still
Pixel art | Artists | Make new colourways of a finished sheet | A recolored version of a character sheet
Game art | Animators | Produce transparent attack loops from one still | An attack loop for a hooded fox or a slime
Scene building | Developers | Compose a scene from finished assets | A village with layered scenery and projected shadows
```

Skip it if you want fully hand drawn animation, since it relies on generation and a curation step for the final touches.

Where to use it: It runs through your agent and a terminal.

- Codex, as a skill
- Claude Code, as a skill
- A terminal, through the Python command line tool
- A browser, for the optional curation view
- Aseprite, Phaser and Flame, through the export step

```table
Use case | Who | What they get back
Animate one character as an atlas | Game developer | A transparent sprite sheet plus a manifest with its frame layout
Make a motion loop for a state | Game artist | A looping transparent GIF, WebP or strip for that state
Recolor a finished sheet | Pixel artist | Deterministic colourways of the sheet
Build a scene from finished assets | Developer | A rendered scene from your assets and a scene file
```

How to use it: Ask your agent for sprites or for an image. It checks access, asks only about the provider and motion choices you have not given, runs the pipeline and delivers the files. The curation view is optional. You can save your choices once as separate defaults for sprites and for images, and a one time request does not overwrite them.

The help command prints a map of the pipelines and groups commands by the part of the code that owns them.

```bash
sprite-gen --help
```

For side view sprites, the facing option takes right or left and is used for both canvas placement and clip prompts. To ask for an orientation in the generation prompt, give a reference image with the facing option.

```text
gen --ref image.png --facing right
```

```table
Tool | What it does
A, atlas rows (prepare, gen, extract, compose-atlas) | Takes one still and a list of states and returns a sprite sheet with transparency and a manifest
B, video to loop (video-canvas, video, video-frames, video-loop) | Animates the still with the Grok video model and returns a transparent GIF, WebP or strip per state
C, utilities (cutout, slice-sheet, unpack-atlas) | Cleans an imported image or grid sheet, or turns a finished atlas into a run you can curate
D, post-processing (recolor, export-) | Makes colourways of a finished sheet and exports for Aseprite, Phaser and Flame
E, asset tools (background-tile, shadow, inspect-motion) | Independent commands for backgrounds, shadows and checking motion
S, scene (scene-render, scene-inspect) | Renders and inspects a scene from existing assets and a scene file
```

Example: You give your agent one still of a slime and ask for an attack loop. The video pipeline animates it with the Grok video model, checks the frames, picks the loop automatically and returns a transparent loop with no manual cut points.

For newcomers and experts: If you are new to this, think of it as a production line for one character. A first small try is to ask your agent for sprites from a single drawing and skip the curation view. You get a transparent sheet and a manifest your game engine can read.

If you know the field, the atlas path generates row by row, locks the character's identity, converts the chroma background to real alpha and extracts each pose as its own frame. The video path cuts clips at their true period so loops repeat cleanly. The facing detector only notes its guess unless told otherwise, and a confident guess can still be mistaken. Mirror and regenerate fixes are opt in, and prompts can request a direction but cannot guarantee it.

```flow
Give one base image of the character
Generate poses row by row
Strip the background to real transparency
Extract each pose as a clean frame
Bake the atlas and its manifest
```

Good to know:

- It needs access to an image or video provider, and the agent checks that before it starts.
- Orientation is only requested in prompts. Fix options such as the mirror option exist, but you should review the still before using them.
- The facing detector is record only unless you turn a fix on, and its guess can be wrong.
- An optional curation view shows frames side by side so you can drop or shift them, and play the loop before baking.
- The license is Apache-2.0.
- Each pipeline has its own page in the docs folder.

## On GitHub, 16 November 2026

- Stars: 4,090
- Forks: 427
- Watching: 13
- Open issues and pull requests: 3
- Language: Python
- License: Apache-2.0
- Topics: 2d-game, ai-tools, claude-code, codex, game-dev, gamedev, pixel-art, sprite-generation, sprite-sheet

## Links

- Code: https://github.com/aldegad/sprite-gen
- Releases: https://github.com/aldegad/sprite-gen/releases
- Issues: https://github.com/aldegad/sprite-gen/issues
- Star history: https://www.star-history.com/#aldegad/sprite-gen&Date

## Intro videos

- 성기사, 늑대, 슬라임 | 스프라이트젠 쇼케이스: https://www.youtube.com/watch?v=zVu9YlbPtog

## Get the code

```
git clone https://github.com/aldegad/sprite-gen.git
```

Then follow the setup in its README. Nothing in this kit runs by itself.
Files
README.md  6 KB

1 file, 6 KB, downloaded as a zip.

What’s new

  • Version 1 · 2026-11-16

Compare with similar

Listed GitHub projects in the same category that share the most topics with this one.

ProductStarsActivityLanguageLicenseLast change
sprite-gen This page4,097ActivePythonApache-2.0
pixelfxShares sprite-sheet · pixel-art · gamedev5,460ActiveJavaScriptMIT
Claude Code Game StudiosShares gamedev · claude-code36,141ActiveShellMIT
Hermes AgentShares codex · claude-code261,224——MIT—
UI UX Pro MaxShares codex · claude-code146,944ActivePythonMIT
GraphifyShares codex · claude-code144,528ActivePythonApache-2.0
Numbers as Mindket last read them, from 2026-11-06 to 2026-11-16. Activity is read from each project’s last change on GitHub: Active within 30 days, Quiet within 180, Stale after that.

Reviews

No ratings yet

Write a review

No reviews yet.

What people say

Posts and comments that name this project on Hacker News, Bluesky, X, Reddit, Facebook and YouTube, found by a weekly search and on Trendshift. Mindket doesn’t write or check them. Open one to read it where it was posted.

Searched

More from Mindket

See all from Mindket

all-mpnet-base-v2

sentence-transformers · Kit

Turns sentences and paragraphs into 768-number vectors so you can search, cluster and compare text by meaning. It suits developers and data teams working in En…

New

multilingual-e5-base

intfloat · Kit

Turns text in about 100 languages into vectors so you can compare meaning across them, for search and matching. Made for developers who build multilingual retr…

New

Monocolor Editorial Print

yanliudesign · Skill

Makes original one-ink and two-ink editorial images from a theme, an object or your photo, for posters, zines, portraits and packaging. Returns the image, the…

New3662

Similar projects

See all in Developer

pixelfx

patch-gg · Skill

Gives games 244 pixel art effects such as fire, explosions, magic and weather, each a small code file, with sprite sheet export for any engine and a Claude Cod…

New5460

Hermes Agent

NousResearch · Kit

Nous Research’s open source agent that you run in a terminal, in a desktop app or from a chat app. It keeps memory, writes skills from experience, runs schedul…

New261k

UI UX Pro Max

nextlevelbuilder · Skill

Generates tailored design systems, including color palettes, typography pairings, and layout patterns, based on specific project requirements and industry stan…

New147k