git404hub

what is cavepainter fr?

uudruid74/cavepainter — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · developerComplexity · 4/5Setup · hard

tl;dr

A server that lets AI agents draw images by controlling real GIMP software through tool calls, instead of using generative image models.

vibe map

mindmap
  root((Cave Painter))
    What it does
      AI agents draw via GIMP
      No generative models
      Persistent drawing sessions
    Tech stack
      Python
      GIMP
      MCP
    Use cases
      Agent controlled drawing
      Incremental canvas edits
      Watch and learn from humans
    Audience
      AI agent developers
      Creative tooling researchers
    Notes
      Hexagonal architecture
      Includes self portrait experiment
      Prometheus real time observation

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Let an AI agent draw images by directly controlling GIMP through tool calls instead of a diffusion model.

VIBE 2

Build incremental drawings where an agent adds shapes, text, and effects step by step on a persistent canvas.

VIBE 3

Watch a human paint in GIMP in real time and have an agent learn techniques from the session.

VIBE 4

Run experiments comparing how different AI agents draw the same kind of image using identical tools.

what's the stack?

PythonGIMPMCP

how it stacks up fr

uudruid74/cavepainter0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultyhardhardhard
Complexity4/54/54/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · hard time til it works · 1h+

Requires a working GIMP installation and connecting an AI agent to the MCP server.

in plain english

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.

prompts (copy fr)

prompt 1
Explain how the persistent GIMP daemon in this project keeps an image session alive between tool calls.
prompt 2
Walk me through the available MCP drawing tools like draw_ellipse and draw_bezier in this repo.
prompt 3
How does the Prometheus feature let an agent observe a human working in GIMP?
prompt 4
Help me set up this project so an AI agent can draw a simple image using GIMP.

Frequently asked questions

what is cavepainter fr?

A server that lets AI agents draw images by controlling real GIMP software through tool calls, instead of using generative image models.

What language is cavepainter written in?

Mainly Python. The stack also includes Python, GIMP, MCP.

How hard is cavepainter to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is cavepainter for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.