GIMPBot

Download GIMPBot

gimpbot-1.1.16.zip

For GIMP 2.10 and GIMP 3.0 or newer — Windows, macOS and Linux. One download for all of them.

Installing on Windows

  1. Download the GIMPBot setup program and double-click it. It finds every GIMP on the machine and installs into each one, with no admin prompt.
  2. If your browser says the file isn’t commonly downloaded, choose Keep. If Windows then says Windows protected your PC, click More info, then Run anyway. Both appear for new downloads they have not seen many copies of yet.
  3. Start GIMP, or restart it if it was open. The window is at Filters › AI Chat.

If Windows blocks the setup program with no Run anyway option — Smart App Control does this — use the zip instead: extract it, then double-click install.bat inside the folder.

Signing in

Send any message in the chat box. Four things then happen:

  1. GIMPBot opens a page in your browser, showing a short code. GIMP is showing the same code.
  2. Enter your email address there. We send you a link — there is no password to choose.
  3. Click that link. It brings you back to the same page, now signed in.
  4. Check the code matches what GIMP is showing, and press Connect GIMP.

GIMPBot picks it up within a second or two and saves the token to a file only you can read. If the code on the page is not the one GIMP is showing, do not approve it.

There is nothing to copy, no environment variable to set and no restart. One sign-in covers every version of GIMP on the machine. If you already have a token from somewhere else, pasting it into the chat box still works and is how you switch accounts.

macOS and Linux

Open Terminal, cd into the unzipped folder, and run:

bash install.sh

Or skip the download entirely — this fetches and installs in one line, and works the same on macOS and Linux:

curl -fsSL https://gimpbot.com/install.sh | bash

It is the same installer that is in the zip, published from the same build, and readable first at gimpbot.com/install.sh.

On Linux it finds GIMP however you installed it — from your distribution, from Flathub, or as a Snap — and installs into every profile it finds. bash install.sh --list shows where it would go without changing anything.

Use the installer rather than copying files by hand. GIMP silently ignores a plug-in that is not executable: it starts normally, logs nothing, and the Filters entry simply never appears. A zip cannot carry that permission bit, so something has to set it. If the menu item is missing, check this first.

If you would rather do it yourself, copy the ai-chat folder into your plug-ins directory — it must keep its own subfolder, named after the script — then chmod +x the script inside it. For GIMP 2.10, copy ai-chat-210/ai-chat-210.py into plug-ins, mark it executable, and put the shared modules in <profile>/ai-chat-lib/ rather than in plug-ins, which would launch each of them as a plug-in of its own.