PerfectPixel is a free, AI-powered sprite animation studio that turns a one-line character description into a base character and then generates over 100 motion animations with correct frame counts, fully transparent backgrounds, and rock-steady alignment.
The app uses your own AI provider key (Gemini, OpenRouter, fal.ai, or BytePlus) to generate the raw art, then passes every result through a deterministic post-processing pipeline written in Go that corrects what the AI gets wrong.
The output is a folder of sprite sheets, Aseprite-compatible JSON, per-state GIFs, APNGs, and individual frame PNGs ready for import into Unity, Godot, Phaser, or any engine that reads standard sprite data.
Features
- Generate a base character from a short description and selected visual style.
- Create animation strips from more than 100 motion presets, including idle, walk, run, attacks, magic, emotes, and reactions.
- Build eight-direction movement sets from generated directions and mirrored variants.
- Review animation playback, individual frames, and regeneration results inside the desktop app.
- Run up to three corrective generation passes when the strip has the wrong frame count, weak motion, or inconsistent character details.
- Remove generated backgrounds and export transparent sprite frames.
- Recenter poses around the character’s visual mass to reduce side-to-side animation jitter.
- Apply shared-palette pixel cleanup to reduce blurred edges, gradients, and color flicker.
- Export sprite sheets, Aseprite-compatible JSON, manifest metadata, individual PNG frames, GIF previews, and APNG files.
Where PerfectPixel Is Useful
Testing combat timing before final art exists
A prototype combat scene needs idle, movement, attack, hurt, and defeat states before final animation work begins. PerfectPixel can produce a temporary animation set for testing hit timing, enemy scale, state transitions, and controller logic.
Building eight-direction movement prototypes
Top-down RPGs, tactical games, and survival games often need directional movement before the game’s visual direction is settled. PerfectPixel creates direction sets from one character concept, then exports the frames needed for movement-state experiments.
Checking an engine import pipeline
Sprite atlas imports, animation metadata, frame timing, and state naming often need validation before an art pipeline becomes expensive. The exported PNG frames, sprite sheet, JSON, and manifest files provide material for testing those workflows.
Expanding a temporary NPC roster
Early encounters need visual distinction even when final character art is not ready. Generating several movement and reaction states for enemies, villagers, companions, or bosses can make prototype scenes easier to evaluate.
Exploring a character’s pixel-art direction
Character proportions, color hierarchy, clothing shapes, and weapon silhouettes often look different once they animate. A small set of idle, walk, and attack states can reveal whether a concept still reads clearly at in-game scale.
Install and Configure PerfectPixel
PerfectPixel runs as a Wails desktop app. The official setup requires Go 1.25 or later, Node.js 18 or later, and Wails v2. Run the Wails diagnostic before starting because desktop dependencies vary by operating system.
git clone https://github.com/gykim80/perfectpixel-studio.git
cd perfectpixel-studio
go install github.com/wailsapp/wails/v2/cmd/wails@latest
wails doctor
./dev.shThe development script starts the app and installs frontend dependencies on its first launch. Build a local desktop version with:
wails buildThe build output goes into the project’s build/bin directory.
PerfectPixel connects to an external image-generation provider. Add a provider key through the desktop settings or create a local .env file from the included example:
cp .env.example .envGeneration requests use the provider you choose. The desktop app stores its own configuration, sessions, and gallery data locally, but local execution does not make image generation offline. Review the billing, request limits, privacy policy, and commercial-use terms for the provider connected to your key.
Create an Animated Sprite Set
Start with the base character by describing the silhouette, clothing, main colors, weapon, hairstyle, and distinguishing details that should remain stable across every frame.
After the base character looks right, add a small set of essential motions. An idle loop, walk cycle, attack, and hurt reaction usually reveal frame-count issues, drifting colors, pose problems, and scale inconsistencies faster than a large export batch.
Review each state in playback mode before creating directional variants. Eight-direction generation expands the asset set quickly, so correcting the initial character and first animation strip saves time later.
Export only after the animation works at the actual game scale. A weapon, face, or foot placement can look acceptable in a large preview but disappear once the sprite appears inside a real scene.
What the Export Folder Contains
PerfectPixel creates a character-named folder that contains the working files for engine import and visual review.
| File or folder | Use |
|---|---|
sprite-sheet.png | Packed atlas containing all exported animation frames |
sprite-sheet.json | Aseprite-compatible frame metadata |
manifest.json | State names, frame data, FPS, loop settings, trims, and foot-pivot data |
frames/<state>/ | Individual PNG files for each animation state |
gif/<state>.gif | Quick animation previews |
apng/<state>.png | Transparent animated previews |
The export structure does not automatically configure a game project. You still need to define animation states, playback rules, scaling, collision boxes, sorting, and engine-specific import settings.
Pros
- Deterministic quality correction.
- Engine-ready Aseprite JSON exports.
- Open source (MIT license).
- Multiple AI provider options.
- Over 100 motion presets.
- Self-correcting retry loop.
- Real pixel-art finishing.
Cons
- Requires a local Go/Node/Wails setup.
- Needs a paid API key.
- Retries increase generation time and cost.
- Output quality depends on the AI model.
FAQs
Q: Is PerfectPixel free to use?
A: The application is open source under the MIT license and costs nothing. You must provide your own API key for an image generation provider, and those services charge based on usage.
Q: Can I use PerfectPixel offline?
A: No. Image generation requires an active API call to the selected AI provider. The deterministic correction pipeline runs locally after the AI returns a result.
Q: Which game engines can I import the output into?
A: Any engine that supports Aseprite JSON imports, including Unity, Godot, and Phaser. The sprite sheet and individual frames are also usable in any engine that reads PNG sprite sheets.
Q: Do I need to know how to code to use PerfectPixel?
A: You need to follow the installation steps for Go, Node, and Wails. The desktop app itself provides a graphic UI for character creation, motion generation, and export.
Q: What happens when the AI gets the frame count wrong?
A: The inspection step detects the mismatch and scores the result. The self-correcting retry loop sends a precise correction hint back to the AI prompt, asking for the exact frame count and clean magenta gutters. The loop tries up to three times and returns the best candidate.
