MCPBytes

Open source · AGPL-3.0 · CLI and MCP server

MCPBytes Pixel Sprites Generator

Describe a character and get a pixel-art sprite sheet: walk cycles facing down, left, right and up, four still poses, looping walk previews and ready-made Godot and Unity imports. It runs on your own NVIDIA GPU, from the command line or from any MCP client.

Animated wizard walking down Animated junkyard robot walking to the right Animated pirate captain walking down Animated astronaut walking to the right
Source on GitHub PyPI package Hosted version

Examples

Four prompts, four characters.

Real, unedited outputs of the hosted create_pixel_sprite tool, which runs this engine: same models, prompt template and processing. Each was one variant with seed 42, generated on September 29, 2026, with the default 32-colour palette, transparent background and walk timing. Shown enlarged with square pixels; the checkerboard is the transparent background.

Wizard

An old wizard in a violet star-embroidered robe with a bent pointed hat and a teal crystal staff, in sixteen pixel-art poses
Animated wizard walking down
Down
Animated wizard walking to the right
Right

Prompt

An ancient wizard with a long braided white beard, a deep violet robe embroidered with silver stars, a wide-brimmed pointed hat bent at the tip, a gnarled oak staff crowned with a glowing teal crystal, and a leather spellbook hanging from a rope belt.

seed 42 · 1 variant · 32-colour palette · transparent

Junkyard robot

A junkyard robot with a rusty orange drum body, one round camera eye and a bent antenna, in sixteen pixel-art poses
Animated junkyard robot walking down
Down
Animated junkyard robot walking to the right
Right

Prompt

A scrappy junkyard robot built from a rusty orange oil drum body, mismatched green and grey arms, a single big round camera eye with a blue lens, a bent antenna with a red bulb, tank treads for feet, and exposed copper wires.

seed 42 · 1 variant · 32-colour palette · transparent

Pirate captain

A pirate captain in a gold-trimmed tricorn hat and scarlet coat with a cutlass, in sixteen pixel-art poses
Animated pirate captain walking down
Down
Animated pirate captain walking to the right
Right

Prompt

A swaggering pirate captain with a black tricorn hat trimmed in gold, a long scarlet coat with brass buttons, a striped shirt, a peg leg, a hook hand, a curved cutlass at the hip and a bright green parrot perched on the shoulder.

seed 42 · 1 variant · 32-colour palette · transparent

Astronaut

An astronaut in a white spacesuit with a gold visor and a grey backpack, in sixteen pixel-art poses
Animated astronaut walking down
Down
Animated astronaut walking to the right
Right

Prompt

A cheerful astronaut in a bulky white spacesuit with orange stripes, a domed helmet with a reflective gold visor, a chunky grey life-support backpack with two small thrusters, mission patches on the chest and thick padded boots.

seed 42 · 1 variant · 32-colour palette · transparent

To try one yourself: mcpbytes-pixel-sprite generate "<prompt>" --seed 42. The same seed and inputs reproduce a result on the same hardware and memory mode; individual pixels can differ between GPUs.

The sheet

Sixteen 32×32 cells, one character.

The wizard sheet with its four rows and four columns of 32 by 32 pixel cells outlined

Every sheet is a 128×128 PNG with one shared palette. Columns 1–3 of each row are walk poses; column 4 holds a still pose.

  1. Facing down: three walk poses, then arms raised.
  2. Facing left: three walk poses, then jump left.
  3. Facing right: three walk poses, then jump right.
  4. Facing up: three walk poses, then lying down.

The walk previews loop poses 1, 2, 3, 2: three drawn poses in a four-frame cycle. Results come marked unreviewed or needs_review, never approved: check anatomy, facing and transparency yourself.

FileWhat it holds
raw_N.pngThe model's 512×512 render, before any processing.
sprite_N.pngThe 128×128 sheet: transparent background, one shared palette.
sprite_N.jsonFrame rectangles and pivots, animations, palette, QA status and warnings.
sprite_N.zipSheet, 16 frames, 4 walk GIFs, manifest, QA and provenance, a Godot 4 scene, a Unity 6 importer and IMPORTING.md.
generation.jsonEffective options, seeds and model revisions (your description is left out).

Get started

Your GPU, or ours.

On your NVIDIA GPU

  • A CUDA 12.8 driver (R570 or newer) on Windows or Linux.
  • About 16 GB of disk for the model files, downloaded once from Hugging Face at pinned commits.
  • uv, or Python 3.11–3.13 with pip.
uvx --torch-backend=auto mcpbytes-pixel-sprite download
uvx --torch-backend=auto mcpbytes-pixel-sprite generate \
  "A forest ranger with a green hood" --seed 42

From any MCP client

Run download once, then add the server; it provides one tool, create_pixel_sprite.

{
  "mcpServers": {
    "pixel-sprite": {
      "command": "uvx",
      "args": ["--torch-backend=auto",
               "mcpbytes-pixel-sprite", "mcp"]
    }
  }
}

No NVIDIA GPU?

--cloud sends the job to MCPBytes GPUs for prepaid credits, with the same files back. Create an API key at console.mcpbytes.com. 

export MCPBYTES_API_KEY=...
uvx mcpbytes-pixel-sprite generate "A forest ranger" --cloud

Options

--variants 1-4, --reference image.png, --opaque, --palette-colors 16|32|64, --palette, --frame-duration-ms and --seed. The README covers each one, the GPU memory modes and the pinned models.