uudruid74/cavepainter — explained in plain English
Analysis updated 2026-05-18
Let an AI agent draw images by directly controlling GIMP through tool calls instead of a diffusion model.
Build incremental drawings where an agent adds shapes, text, and effects step by step on a persistent canvas.
Watch a human paint in GIMP in real time and have an agent learn techniques from the session.
Run experiments comparing how different AI agents draw the same kind of image using identical tools.
| uudruid74/cavepainter | 0xustaz/streamgate | a-bissell/unleash-lite | |
|---|---|---|---|
| Stars | 1 | 1 | 1 |
| Language | Python | Python | Python |
| Setup difficulty | hard | hard | hard |
| Complexity | 4/5 | 4/5 | 4/5 |
| Audience | developer | developer | researcher |
Figures from each repo's GitHub metadata at analysis time.
Requires a working GIMP installation and connecting an AI agent to the MCP server.
Cave Painter is an experimental server that lets AI agents draw pictures using GIMP, the real desktop image editing program, instead of using generative or diffusion based AI image models. Agents call simple tools like create a canvas, draw an ellipse, add text, and export, and each of these calls goes to a GIMP process that stays running between commands. This means an agent can build up an image step by step with real edits, the same way a person clicking around in GIMP would, rather than regenerating a whole image from scratch each time. Under the hood, the project is organized so the core drawing logic does not depend on GIMP specifically, with GIMP plugged in as one possible backend. The available tools cover things like creating canvases and layers, drawing shapes such as ellipses, rectangles, and bezier curves, rendering text, applying filters like blur or glow, and exporting finished images as PNG files. A separate feature called Prometheus lets an agent watch a human working in GIMP in real time, reading dialog settings and canvas changes as the person paints, so the agent can learn techniques from watching rather than only acting on its own. The README also describes an experiment where three separate AI agents were each asked to draw a self-portrait using only these drawing tools, with no generative image model involved. A fourth AI then judged the resulting images without seeing any of the underlying code. The author notes that two of the three agents ended up with very similar background colors, which they suggest may point to shared bias coming from using the same underlying model provider. This project would interest developers experimenting with AI agents that control real creative software instead of prompting an image generator, or anyone curious about giving an AI agent direct, tool based control over an existing application like GIMP.
A server that lets AI agents draw images by controlling real GIMP software through tool calls, instead of using generative image models.
Mainly Python. The stack also includes Python, GIMP, MCP.
Setup difficulty is rated hard, with roughly 1h+ to a first successful run.
Mainly developer.
This repo across BitVibe Labs
double-check against the repo, no cap.