hanzo-tools-gimp
Unified GIMP automation tool for Hanzo AI (HIP-0300).
Drives GIMP 3.0 through the Hanzo GIMP bridge — a
clean-room, BSD-3 GIMP plug-in (see hanzo/gimp-mcp) that exposes GIMP's
Procedural Database (PDB) over a line-oriented JSON TCP socket. This package is
the Python client for that bridge.
This is a clean-room implementation with no GPL lineage: both the bridge and this client use GIMP's documented, public PDB / GObject-Introspection API.
Install
pip install hanzo-tools-gimp
Prerequisites
The Hanzo GIMP bridge plug-in must be running inside GIMP. Briefly:
- Copy
hanzo_gimp_bridge.py(fromhanzo/gimp-mcp) into your GIMP 3.0 plug-ins directory (one folder per plug-in, script made executable). - Start GIMP and run Filters → Hanzo → Start Hanzo Bridge.
- The bridge listens on
127.0.0.1:9876by default (override withHANZO_GIMP_PORT/HANZO_GIMP_HOST).
See the gimp-mcp repo's README.md and PROTOCOL.md for full details.
Usage
from hanzo_tools.gimp import GimpTool, register_tools, TOOLS
# Register with a FastMCP server
register_tools(mcp_server) # optional host=..., port=...
# Or use the tool directly
tool = GimpTool(host="127.0.0.1", port=9876)
The tool exposes the same action surface as the Hanzo MCP TypeScript gimp
tool:
| Action | Params | Result |
|---|---|---|
version |
— | {bridge, gimp, protocol} |
open |
path |
{image_id, width, height} |
export |
image_id, path |
{image_id, path, saved} |
pdb_call |
procedure, args |
the procedure's return value(s) |
new_image |
width, height |
{image_id, width, height} |
image_info |
image_id |
{image_id, width, height, ...} |
list_procedures |
prefix? |
{count, procedures} |
flatten |
image_id |
{image_id, layer_id} |
Every action also accepts host / port overrides.
pdb_call is the generic escape hatch — it can invoke any PDB procedure,
so anything GIMP can do is reachable.
License
BSD-3-Clause. Copyright (c) 2026 Hanzo AI.
Metadata
Release files for hanzo-tools-gimp 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| hanzo_tools_gimp-1.0.0.tar.gz | 6.8 kB | Without provenance | Details for hanzo_tools_gimp-1.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| hanzo_tools_gimp-1.0.0-py3-none-any.whl | Python 3 | none | any | Details for hanzo_tools_gimp-1.0.0-py3-none-any.whl |
Total release size: 13.7 kB
Release files / hanzo_tools_gimp-1.0.0.tar.gz
| Download URL | hanzo_tools_gimp-1.0.0.tar.gz |
|---|---|
| Size | 6.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f587d42c753ff50e101c268f9c525981d423a953390c4f19ecf241449d0983e9
|
|
BLAKE2b-256 checksum How to use checksums |
784f3e297ebbd7ab10fbefec455a6aeed5d2c9503b8bdc912ab48c0fda4cd7ae
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.25 {"installer":{"name":"uv","version":"0.11.25","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / hanzo_tools_gimp-1.0.0-py3-none-any.whl
| Download URL | hanzo_tools_gimp-1.0.0-py3-none-any.whl |
|---|---|
| Size | 6.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
61218e23c644e46ff5723f01f6d6eb05a9e91c260bed21f9c147f1d4113a52c6
|
|
BLAKE2b-256 checksum How to use checksums |
8cc8f113d10224bdf9bfa247fbd91a54f69c84349528482beab771d9471abc5a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.25 {"installer":{"name":"uv","version":"0.11.25","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for hanzo-tools-gimp 1.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.