mirror of https://github.com/NousResearch/hermes-agent.git synced 2026-04-25 00:51:20 +00:00

feat(pixel-art): add hardware palettes and video animation (#12725 )

Expand the pixel-art skill from 2 presets (arcade, snes) to 14 presets
with hardware-accurate palettes (NES, Game Boy, PICO-8, C64, Apple II,
MS Paint, CRT mono), plus a procedural video overlay pipeline.

Ported from Synero/pixel-art-studio (MIT). Full attribution in
ATTRIBUTION.md.

What's in:
- scripts/palettes.py — 28 named RGB palettes (hardware + artistic)
- scripts/pixel_art.py — 14 presets, named palette support, CLI
- scripts/pixel_art_video.py — 12 animation scenes (stars, rain,
  fireflies, snow, embers, lightning, etc.) → MP4/GIF via ffmpeg
- references/palettes.md — palette catalog
- SKILL.md — clarify-tool workflow (offer style, then optional scene)

What's out (intentional):
- Wu's quantizer (PIL's built-in quantize suffices)
- Sobel edge-aware downsample (scipy dep not worth it)
- Atkinson/Bayer dither (would need numpy reimpl)
- Pollinations text-to-image (Hermes uses image_generate instead)

Video pipeline uses subprocess.run with check=True (replaces os.system)
and tempfile.TemporaryDirectory (replaces manual cleanup).

2026-04-19 16:59:20 -07:00

1.7 KiB

Raw Blame History

Named Palettes

28 hardware-accurate and artistic palettes available to pixel_art(). Palette values are sourced from pixel-art-studio (MIT) — see ATTRIBUTION.md in the skill root.

Usage: pass the palette name as palette= or let a preset select it.

pixel_art("in.png", "out.png", preset="nes")           # preset selects NES
pixel_art("in.png", "out.png", preset="custom", palette="PICO_8", block=6)

Hardware Palettes

Name	Colors	Source
`NES`	54	Nintendo NES
`C64`	16	Commodore 64
`COMMODORE_64`	16	Commodore 64 (alt)
`ZX_SPECTRUM`	8	Sinclair ZX Spectrum
`APPLE_II_LO`	16	Apple II lo-res
`APPLE_II_HI`	6	Apple II hi-res
`GAMEBOY_ORIGINAL`	4	Game Boy DMG (green)
`GAMEBOY_POCKET`	4	Game Boy Pocket (grey)
`GAMEBOY_VIRTUALBOY`	4	Virtual Boy (red)
`PICO_8`	16	PICO-8 fantasy console
`TELETEXT`	8	BBC Teletext
`CGA_MODE4_PAL1`	4	IBM CGA
`MSX`	15	MSX
`MICROSOFT_WINDOWS_16`	16	Windows 3.x default
`MICROSOFT_WINDOWS_PAINT`	24	MS Paint classic
`MONO_BW`	2	Black and white
`MONO_AMBER`	2	Amber monochrome
`MONO_GREEN`	2	Green monochrome

Artistic Palettes

Name	Colors	Feel
`PASTEL_DREAM`	10	Soft pastels
`NEON_CYBER`	10	Cyberpunk neon
`RETRO_WARM`	10	Warm 70s
`OCEAN_DEEP`	10	Blue gradient
`FOREST_MOSS`	10	Green naturals
`SUNSET_FIRE`	10	Red to yellow
`ARCTIC_ICE`	10	Cool blues and whites
`VINTAGE_ROSE`	10	Rose mauves
`EARTH_CLAY`	10	Terracotta browns
`ELECTRIC_VIOLET`	10	Violet gradient

1.7 KiB Raw Blame History

Named Palettes

Hardware Palettes

Artistic Palettes

1.7 KiB

Raw Blame History