pixel-art

Convert images into retro pixel art with Python and built-in palettes.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/azmiariffaris/HERMES-AGENT --skill pixel-art-azmiariffaris
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pixel-art
Source: https://github.com/azmiariffaris/HERMES-AGENT/tree/main/snapshot/hermes/skills/creative/pixel-art
Command: npx skills add https://github.com/azmiariffaris/HERMES-AGENT --skill pixel-art-azmiariffaris

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires Pillow, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Pixel Art converts images into retro pixel art with palette control and optional animation, making visuals that resemble classic arcade styles without manual editing.

Core Features & Use Cases

  • Hardware-paletted pixel art conversion (NES, Game Boy, C64, etc.) with Floyd-Steinberg dithering.
  • Optional animation pipeline to overlay effects and export MP4 or GIF using pixel_art_video.py.
  • CLI and Python API support for batch processing, presets, and custom palettes in creative projects.

Quick Start

Run pixel_art.py on an input image to generate a pixel-art PNG, then optionally run pixel_art_video.py to create an animated video.

Frequently Asked Questions about pixel-art

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert an image into retro pixel art using Python?

You can convert images into retro pixel art using Python by running the pixel_art.py script with the Pillow library to apply hardware palettes and Floyd-Steinberg dithering to generate a pixel-art PNG.

How does palette quantization work for pixel art conversion?

Palette quantization restricts image colors to predefined hardware palettes like NES or Game Boy, applying Floyd-Steinberg dithering to simulate shades and produce classic arcade-style pixel art visuals.

Can I create an animated pixel art video from a static image?

Yes, you can create an animated pixel art video by running pixel_art_video.py after generating a static pixel-art image, which overlays effects and exports the result as an MP4 or GIF.

Do I need ffmpeg to export pixel art animations as MP4 or GIF?

Yes, ffmpeg is required for video output when exporting animated pixel art as MP4 or GIF, while Python 3.9+ and Pillow handle the initial static image processing and palette quantization.

Does this pixel art conversion tool support batch processing and custom palettes?

Yes, the tool supports batch processing and custom palettes through both CLI and Python API, allowing you to apply named presets or custom color palettes across multiple images for creative projects.

What are the limitations of using built-in palettes for pixel art generation?

Built-in hardware palettes restrict color quantization to specific retro console limitations, meaning highly detailed source images may lose subtle gradients or require custom palettes to preserve specific color tones.