Offline, headless pixel-art editor: draw, animate, inspect, and export sprites and fonts.
The io.github.marmikshah/atelier MCP server provides access to an offline, headless pixel-art editor. It supports drawing and working with pixel art through non-interactive operation, with capabilities to animate, inspect, and export sprites and fonts.
🛠️ Key Features
Offline pixel-art editing
Headless (non-GUI) workflow
Draw pixel art
Animate content
Inspect assets
Export sprites and fonts
🚀 Use Cases
Automating sprite creation and export in environments without a display
Generating and exporting pixel-art sprites
Creating and exporting pixel-font assets
Inspecting pixel-art assets programmatically
⚡ Developer Benefits
Supports offline use
Suitable for headless pipelines (e.g., CI or server-side asset generation)
Enables sprite and font export workflows
⚠️ Limitations
No additional tool count, topics, or API surface details are provided in the available server data.
Atelier is an offline, headless pixel-art editor for command-line tools and AI agents. Create layered sprites and animations, inspect pixels, and export PNGs, spritesheets, GIFs, APNGs, and TrueType pixel fonts. Documents stay local.
Use it directly from a shell, or connect an agent such as Claude Code or Codex through MCP (Model Context Protocol). Both interfaces expose the same editing tools; no graphical editor or running server is needed for CLI calls.
Drawn by an agent through Atelier's tools. Each is rebuilt byte for byte from
the recipe beside it in CI.
A more complex design made by combining physics simulation with Atelier MCP using Opus 5.5.
The replay file is too large to include here.
Download it from Google Drive if needed.
Showcase
Animation showcase — compare models and briefs, view animations, and download replays.
On macOS, Ubuntu, or any other Linux, paste this into a terminal:
sh
curl -fsSL https://github.com/marmikshah/atelier/releases/latest/download/install.sh | sh
Ubuntu Desktop comes without curl; use wget instead:
sh
wget -qO- https://github.com/marmikshah/atelier/releases/latest/download/install.sh | sh
It downloads Atelier for your machine, checks it, puts it in ~/.local/bin, and adds that to your PATH. If Claude Code or Codex is installed, it also connects Atelier to them: they get its drawing tools in every project and its guides for drawing sprites and scenes and reviewing art. Nothing else is needed, not even Rust.
Then start a new agent session and ask for something:
Use atelier to draw a 32×32 animated torch and save it as torch.gif.
Your art is kept in ~/.atelier. To keep a project's art inside the project instead, run atelier init in its folder before you start the agent.
Update: Run the install command again.
Installed Claude Code or Codex afterwards? Run atelier connect.
A specific version or folder, or no profile changes: Set ATELIER_VERSION, ATELIER_INSTALL_DIR, or ATELIER_NO_MODIFY_PATH=1; install.sh lists every option.
Uninstall
sh
atelier uninstall
It lists what it will remove and asks before deleting anything: Atelier's registration in Claude Code and Codex, its skills, the PATH line it added, the atelier program, and the Linux background server if you set one up.
Your art in ~/.atelier is kept; add --documents to delete it as well. Folders set up with atelier init are never touched.
Other ways to run it
From the terminal. Every tool is one command: atelier call TOOL '<json>'. Your first sprite walks through creating, drawing, and saving an image.
In Cursor and other MCP clients. Install as above, then register the path command -v atelier prints as a stdio server with no arguments, and run atelier skills install --for cursor (or --dir PATH for another skills folder) for the drawing guides:
Atelier is at 0.2. master is the current source; releases are dispatched from it and publish the macOS and Linux binaries, the container image, a vX.Y.Z tag, and the MCP Registry entry.
Your documents are not discarded. Edits are journaled and committed atomically. A document that is damaged, or saved by a build with a different document schema, is refused with an error and left unchanged on disk.
The document format is versioned, with no migration. If an update changes it, documents saved before it are refused, stay on disk untouched, and open again with the commit that wrote them.
A recipe is the plain log of the calls that built a document, one JSON line each. It has no version of its own: what it draws depends on how the tools behave, so a recipe from one commit replays exactly on commits whose tools draw the same way.
Tool names and arguments can still change between commits. Pin a commit if you script against them, and read the current surface from atelier tools --markdown.
How it is built
100% of this code was written by AI. Atelier began as an experiment in whether agents, using only tool calls, can make art useful in games. My part has been giving direction, and I hope the result helps you make something of your own.
CI checks formatting, strict Clippy, and the Rust test suite on Linux and macOS, smoke-tests the container, and replays every showcase recipe, which must reproduce its GIF byte for byte. The security policy describes the network and file-access boundaries.
NOTE
None of the code has had line-by-line human review. Bugs, security issues, and breaking changes are still possible. Please review the code and work with copies of important data before using it in production.
Contributing
Bug reports and questions are welcome as issues; include the checkout commit and a minimal command sequence or recipe file. Pull requests from outside the project are not accepted. Report vulnerabilities privately through the security policy.