Skip to content
Back to search

sprite-forge

Local text-to-2D game art for Claude, Codex and any MCP client: transparent sprites, icons, true pixel art (real grid, locked palette), characters with 4/8-direction turnarounds and animation sprite sheets, seamless tiles and VFX on your own GPU via ComfyUI (FLUX.2 Klein 4B, Z-Image Turbo, Qwen-Image-Edit). MCP server + agent skill.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/noamcelermajer--comfyui-text-to-sprite-mcp/badge.svg)](/listings/noamcelermajer--comfyui-text-to-sprite-mcp)

HTML

<a href="/listings/noamcelermajer--comfyui-text-to-sprite-mcp"><img src="/api/listings/noamcelermajer--comfyui-text-to-sprite-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

The easiest way: paste [SETUP_PROMPT.md](SETUP_PROMPT.md) into Claude Code or Codex. By hand:

git clone https://github.com/Noamcelermajer/comfyui-text-to-sprite-mcp SpriteForge
cd SpriteForge
python forge.py setup        # models for this GPU (--dry-run to preview, --all for Qwen-Image-Edit)
python forge.py doctor       # every profile should be "ready": true
python forge.py connect      # registers the MCP server and the skill for Claude and Codex

Sprite Forge finds ComfyUI next to it or through `SPRITEFORGE_COMFY`, starts it when needed, and hands over to ComfyUI's Python for the image libraries. Full unattended instructions for agents: [AGENTS.md](AGENTS.md).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 11 lines
  1. {
  2. "name": "sprite-forge",
  3. "owner": {"name": "Noamcelermajer"},
  4. "plugins": [
  5. {
  6. "name": "sprite-forge",
  7. "source": "./",
  8. "description": "Local 2D game art (sprites, pixel art, character sheets, tiles, VFX) on ComfyUI, as an MCP server plus a skill."
  9. }
  10. ]
  11. }
README.md · README · 188 lines
  1. # Sprite Forge - local text-to-2D game art for Claude, Codex and any MCP client
  2. **Turn a sentence into game-ready 2D art on your own GPU.** Free, private and offline:
  3. transparent sprites and icons, **true pixel art** (a real pixel grid and a locked palette, not
  4. just a pixel "look"), characters with 4/8-direction turnarounds and animation sprite sheets,
  5. seamless tiles, portraits and VFX frames, **animating your own pixel sprites from a description**,
  6. and **normal maps for 2D lighting** - driven by your coding agent or the command line.
  7. [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
  8. [![MCP server](https://img.shields.io/badge/MCP-server-blueviolet)](https://modelcontextprotocol.io)
  9. [![Agent skill](https://img.shields.io/badge/Agent%20Skill-SKILL.md-orange)](skills/sprite-forge/SKILL.md)
  10. [![ComfyUI](https://img.shields.io/badge/ComfyUI-0.45%2B-informational)](https://github.com/comfyanonymous/ComfyUI)
  11. > "make a 32-pixel knight for my platformer, then give him a walk cycle" &rarr; your agent
  12. > creates the character, renders the walk frames from it, snaps every frame to one pixel grid
  13. > and one palette, and hands back a sprite sheet with a JSON atlas your engine imports.
  14. Part of a set: [Asset Forge](https://github.com/Noamcelermajer/comfyui-text-to-3d-mcp) (3D models)
  15. and [Sound Forge](https://github.com/Noamcelermajer/comfyui-text-to-audio-mcp) (audio) use the same
  16. profile / preset / skill design.
  17. **Why Sprite Forge**
  18. - **No credits, no cloud.** Everything runs on your own NVIDIA card.
  19. - **Commercially clean by default.** Every model it installs is Apache 2.0 or MIT. Popular
  20. alternatives that are *not* (Qwen-Image 2.1, FLUX.2 Klein 9B, RMBG-2.0) are left out on purpose.
  21. - **Game-ready, not just generated.** BiRefNet cut-out, halo removal (defringe), crop, canvas
  22. and padding, feet-on-the-ground alignment for characters, sprite sheets with
  23. TexturePacker/Phaser JSON atlases (Phaser, Godot via Sprite Atlas Importer, Unity importers).
  24. - **Real pixel art.** Models only draw pixel-art *style* - blocks of uneven size, blurred
  25. edges, hundreds of colours. Sprite Forge recovers the grid the way the best open
  26. "unfakers" do (edge-profile cell detection with drift-following boundaries, dominant
  27. colour per cell, OKLab palette matching, orphan cleanup, hard alpha), with named palettes
  28. (PICO-8, Game Boy, NES, Endesga 32, Sweetie 16) or **one frozen palette for your whole game**.
  29. - **Animate your own pixel art.** Give it a sprite and "swinging the sword down" (or one line per
  30. frame); every frame is redrawn from the sprite and snapped back onto its exact pixel grid and
  31. palette, so the animation matches the original.
  32. - **Normal maps.** Relief inferred from the drawing (outline, colour regions, highlights), like
  33. Laigter / SpriteIlluminator, in OpenGL or DirectX convention, crisp on pixel art.
  34. - **Characters stay themselves.** A character is created once and saved; turnarounds and
  35. animations are reference edits of it, ranked by CLIP likeness to the reference.
  36. - **Best of N.** Several takes per call, ranked by prompt match (CLIP) and by the checks
  37. (cut off, several objects, background left in, pixel-grid quality); the rest are kept.
  38. - **Fast / standard / max presets** and **hardware tiers** (8 / 12 / 16 / 24 GB).
  39. - **Swap models without code.** Each kind of asset is a small JSON profile around a ComfyUI graph.
  40. ## What it makes
  41. | Profile | For | Model | Output |
  42. | :--- | :--- | :--- | :--- |
  43. | `sprite` | props, items, weapons, furniture, UI pieces | FLUX.2 Klein 4B | transparent PNG on a square canvas |
  44. | `icon` | skill / item icons, badges, buttons | FLUX.2 Klein 4B | PNG + 256/128/64 px |
  45. | `pixel_sprite` | pixel-art characters, items, enemies | Klein 4B + pixel-art LoRA | real 16-64 px pixel art, hard alpha, limited palette, x8 preview |
  46. | `character` / `pixel_character` | a reusable character reference | Klein 4B (+ LoRA) | full-body transparent PNG |
  47. | `turnaround` | 4 or 8 facing directions | Klein 4B edit (max: Qwen-Image-Edit 2511) | frames + sheet + atlas |
  48. | `animation` | walk, run, idle, attack, jump, hurt, death, cast | Klein 4B edit (max: Qwen-Image-Edit 2511) | frames + sheet + atlas with an animation tag |
  49. | `tile` | ground, walls, floors, water, foliage | Klein 4B (max: Z-Image Turbo) | seamless texture + 3x3 preview, optional pixel version |
  50. | `portrait` | dialogue portraits, cards, key art | Z-Image Turbo | full-resolution image |
  51. | `vfx` | explosions, smoke, magic bursts | Klein 4B + edits | frames + sheet + atlas, brightness as alpha |
  52. | `animate_pixel` | animate an existing pixel sprite from a description | Klein 4B edit + pixel LoRA | frames on the sprite's own grid and palette + sheet + atlas + GIF |
  53. Every sheet comes with a looping GIF. Any sprite or sheet can also get a **normal map**
  54. (`normal_map: true`, or `make_normal_map` / `forge.py normal` for any PNG) for Godot / Unity 2D
  55. lights, with a preview lit from four sides; pixel art keeps its grid with crisp, snapped normals.
  56. Sheets can be pixel art too: pass `pixel_grid` (e.g. 32) and every frame is converted with
  57. **one** pixel size and **one** palette, so the character never changes colour between frames.
  58. ## Measured
  59. RTX 5080 16 GB, standard preset, seed 1234 (`tests/smoke_test.py`). Times are the whole call:
  60. generation, cut-out, ranking and saving. The first call of a session adds about 10 s while
  61. weights load. Every job passed its checks; the results were also inspected by eye.
  62. | Job | Result | Time |
  63. | :--- | :--- | ---: |
  64. | `sprite` mana potion, 4 takes | 512x512 transparent PNG | 10-18 s |
  65. | `sprite` treasure chest, 4 takes | 512x512 transparent PNG | 9.8 s |
  66. | `icon` flaming sword, 4 takes | 512 + 256/128/64 px | 8-15 s |
  67. | `pixel_sprite` knight, grid 32 | 20x32 px, 15 colours, hard alpha | 7 s |
  68. | `pixel_sprite` slime, grid 24, PICO-8, outline | 21x24 px, 5 PICO-8 colours | 5.5 s |
  69. | `tile` mossy cobblestone, 3 takes | 512x512 seamless | 6.8 s |
  70. | `tile` grass, pixelized | 512x512 + 32 px pixel tile | 7 s |
  71. | `character` ranger, 4 takes | 768x768 reference | 8 s |
  72. | `turnaround` ranger, 8 directions (5 generated, 3 mirrored) | 8 frames, sheet + atlas | 62 s |
  73. | `animation` ranger walk, facing right, 4 frames | 4 frames, sheet + atlas | 67 s |
  74. | `vfx` explosion, 6 frames | 6 frames, sheet + atlas | 25-29 s |
  75. | `portrait` dwarf blacksmith, Z-Image Turbo, 2 takes | 1024x1024 | 36 s |
  76. | `sprite` / `icon` / `tile` / `character` at `max` (Z-Image Turbo, 4 takes) | as above | 36 / 18 / 25 / 31 s |
  77. | `turnaround` ranger at `max` (Qwen-Image-Edit 2511), 8 directions | 8 frames, real back views, likeness 0.85-0.95 | 104 s |
  78. | `animation` ranger walk at `max` (Qwen-Image-Edit 2511), 4 frames | 4 frames, likeness 0.94-0.99 | 82 s |
  79. | `animate_pixel` knight sword swing, 4 frames from one-line poses | 30x47 px frames, original palette, sheet + GIF + normal map | 65 s |
  80. | `animate_pixel` slime bounce (procedural squash and stretch) | 6 frames, exact palette and outline | < 1 s |
  81. | `make_normal_map` on a 32 px sprite | normal map + 4-light preview | < 1 s |
  82. The whole GPU peaked at about 15.5 GB while ComfyUI kept the models cached; the models
  83. themselves are 4 GB (Klein) + 5.6 GB (text encoder). What the first test run found and fixed:
  84. the icon prompt's "strong silhouette" wording produced black silhouettes (now asked for in
  85. colour, and a flat single-colour check catches it); the edit model kept every VFX stage at
  86. the peak's size (the timing is now enforced); pixel `grid: "auto"` locked onto noise-sized
  87. cells (now limited to plausible sprite pixels). Offline tests (`tests/test_offline.py`) cover
  88. the processing: pixel-grid recovery restores 100% of a distorted 24x32 test sprite, where a
  89. plain resize gets 67%.
  90. Animation frames are key poses edited from the character, not in-betweens: expect to touch
  91. them up. Effects come out best as fire, smoke and magic on black.
  92. ## Requirements
  93. - NVIDIA GPU with 8 GB of VRAM or more (16 GB tested), Windows or Linux
  94. - ComfyUI 0.45 or newer (portable build is fine) and git; no custom node packs
  95. - About 25 GB of free disk for the default models (18 GB download), 55 GB with `--all`
  96. | VRAM | What you get |
  97. | :--- | :--- |
  98. | 8 GB | Everything at `standard`, at most 2 takes; turnaround/animation `max` stays on Klein (the 20B edit model does not fit). |
  99. | 12 GB | Everything; the Qwen-Image-Edit `max` presets run with offloading, one take per frame. |
  100. | 16 GB | Everything (reference machine, RTX 5080). |
  101. | 24 GB+ | Everything, with room for more takes. |
  102. ## Install
  103. The easiest way: paste [SETUP_PROMPT.md](SETUP_PROMPT.md) into Claude Code or Codex. By hand:
  104. ```
  105. git clone https://github.com/Noamcelermajer/comfyui-text-to-sprite-mcp SpriteForge
  106. cd SpriteForge
  107. python forge.py setup # models for this GPU (--dry-run to preview, --all for Qwen-Image-Edit)
  108. python forge.py doctor # every profile should be "ready": true
  109. python forge.py connect # registers the MCP server and the skill for Claude and Codex
  110. ```
  111. Sprite Forge finds ComfyUI next to it or through `SPRITEFORGE_COMFY`, starts it when needed,
  112. and hands over to ComfyUI's Python for the image libraries. Full unattended instructions
  113. for agents: [AGENTS.md](AGENTS.md).
  114. ## Use
  115. From an agent: just ask ("make a 32x32 pixel-art slime enemy with the PICO-8 palette"). The
  116. skill tells it which profile, parameters and prompt style to use, and every result comes back
  117. with a preview image the agent looks at. The MCP server has 9 tools: `list_profiles`,
  118. `generate_sprite`, `create_character`, `animate_pixel`, `make_normal_map`, `get_job`, `check_image`, `models`,
  119. `forge_status`.
  120. From the command line (every command prints one JSON object):
  121. ```
  122. python forge.py sprite potion "a glowing blue mana potion in a round glass flask" --project ../MyGame
  123. python forge.py sprite slime "a cute green slime with big eyes" -p pixel_sprite --set grid=24 --set palette=pico8
  124. python forge.py character ranger "a young ranger with red hair, green hooded cloak, leather armour, a longbow"
  125. python forge.py sprite ranger_dirs -p turnaround --character ranger --set directions=8
  126. python forge.py sprite ranger_walk -p animation --character ranger --set action=walk --set facing=right
  127. python forge.py sprite grass "short green grass with small flowers" -p tile --set pixelize=true
  128. python forge.py sprite boom "fiery orange explosion with black smoke" -p vfx --set frames=6
  129. python forge.py animate slime_bounce slime.png "bouncing up and down, squashing when it lands" --frames 4
  130. python forge.py animate knight_swing knight.png "swinging his sword" --pose "raising the sword high" --pose "swinging it down in front of him"
  131. python forge.py normal knight.png # knight_normal.png + knight_lit_preview.png
  132. python forge.py sprite crate "a wooden crate" --set normal_map=true
  133. python forge.py check some_sprite.png --kind sprite
  134. ```
  135. Exit code 0 = ok, 2 = written but failed its check (see `problems`), 1 = error.
  136. ## Customising
  137. - **Per game:** `python forge.py init <game folder>` writes a `spriteforge.json` with the
  138. output folder, characters folder, style and per-profile settings. Set
  139. `{"pixel_sprite": {"params": {"palette": "project"}}}` to give the whole game one palette
  140. (`palette.hex`, Lospec format - you can also drop in your own).
  141. - **Per call:** `--set key=value` / `params` (`size`, `candidates`, `view`, `grid`, `palette`,
  142. `outline`, `directions`, `action`, `facing`, `pixel_grid`, ...). `forge.py profiles` explains
  143. every parameter.
  144. - **New profile:** a JSON file in `profiles/user/` or the game's `spriteforge_profiles/`
  145. that `extends` an existing one.
  146. - **New model:** add it to `models/catalog.json` and write a profile around a ComfyUI API
  147. graph in `graphs/`.
  148. Settings are layered: profile, hardware tier, project, preset, style, call; the tier's
  149. limits are applied last so a call cannot run an 8 GB card out of memory.
  150. ## Licences
  151. Sprite Forge's code is MIT. Every model it installs allows commercial use of your outputs
  152. (FLUX.2 Klein 4B, Z-Image Turbo, Qwen-Image-Edit 2511, the pixel-art LoRA: Apache 2.0;
  153. BiRefNet, CLIP: MIT). Details in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md). Some stores
  154. ban or require disclosure of AI-generated assets - check where you publish.
  155. Not to be confused with other projects named "SpriteForge".

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.