retro-diffusion/pixel-art-fixer — explained in plain English
Analysis updated 2026-05-18
Clean up AI-generated pixel art so it has a true, editable pixel grid.
Batch-process a folder of images to fix fake pixel art at scale using the Rust version.
Recover the original resolution of a pixel art sprite saved at the wrong size.
Prepare pixel art assets for tiling, recoloring, or frame-by-frame animation.
| retro-diffusion/pixel-art-fixer | 6-robot/jie_3d_nav | pydantic/httpx2 | |
|---|---|---|---|
| Stars | 183 | 190 | 176 |
| Language | Python | Python | Python |
| Setup difficulty | moderate | hard | easy |
| Complexity | 3/5 | 4/5 | 2/5 |
| Audience | developer | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Python version needs numpy, scipy, opencv-python, and Pillow installed via pip, Rust version is a single dependency-free binary.
Pixel Art Fixer takes images that look like pixel art but are not actually built from a clean pixel grid, and converts them into real, grid-aligned pixel art. This is pure image processing, no AI model is used to do the conversion itself. The problem it solves is common with AI image generators, upscalers, and lossy image pipelines: they often produce pictures that look pixelated, but the pixels do not line up to a clean grid, cell sizes are not whole numbers, edges are blurred together, or the image is saved at a much higher resolution than the actual art it contains. None of these fake versions can be properly tiled, recolored, animated, or edited pixel by pixel until they are converted back into true pixels. Most existing tools try to detect a single repeating pattern in the image and snap everything to it, which often picks up the wrong scale, such as a texture or a face, instead of the actual pixel grid. Pixel Art Fixer instead uses three separate detection methods that each look for the grid in a different way. When they agree, that answer is trusted. When they disagree, a more detailed scoring system steps in to resolve the harder cases, including things like non-whole-number cell sizes, warped grids, and heavy blur or JPEG compression damage. Once the grid is figured out, the tool separates two decisions: where each pixel boundary goes, and what color each pixel should be. This keeps edges crisp while still preserving accurate colors, including small details that a simpler tool might lose. According to the project's own benchmark testing across thousands of damaged sample images, Pixel Art Fixer recovers the original image size correctly far more often than other tools it was compared against. The project includes two versions, one written in Python for readability, and one written in Rust that runs significantly faster, meant for servers and processing many images at once. For images too damaged for this method to fully recover, the team also offers a separate AI based version.
A tool that converts fake, blurry pixel art images into real, grid-aligned pixel art using image processing, no AI model required.
Mainly Python. The stack also includes Python, Rust, OpenCV.
The README references a License section but does not state the specific terms in the visible content.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
double-check against the repo, no cap.