harness-gimp
Agent-first Python package for safe, scriptable image edits with GIMP.
- JSON-first CLI for LLM/tooling use
- Bridge-first architecture
- GIMP 3 batch execution backend
- Validation and deterministic outputs
Install
pip install harnessgg-gimp
Quick Start
harness-gimp bridge start
harness-gimp doctor
harness-gimp inspect input.jpg
harness-gimp resize input.jpg --width 1024 --height 768 --output resized.png
harness-gimp crop resized.png --x 0 --y 0 --width 800 --height 600 --output cropped.png
harness-gimp crop-center resized.png --width 800 --height 800 --output centered.png
harness-gimp export input.jpg output.webp
harness-gimp bridge status
All commands print one JSON object to stdout.
Note: layer-edit commands are most reliable on .xcf working files.
Tip: prefer harness-gimp or harnessgg-gimp CLI entrypoints over python -m harness_gimp in mixed environments.
Tip: bridge start --port ... persists the bridge URL for later commands; override anytime with HARNESS_GIMP_BRIDGE_URL. Set HARNESS_GIMP_STATE_DIR to customize where bridge state files are stored.
Docs
- Human commands:
docs/human/commands.md - LLM quickstart:
docs/llm/quickstart.md - LLM command spec:
docs/llm/command-spec.md - LLM bridge protocol:
docs/llm/bridge-protocol.md - LLM response schema:
docs/llm/response-schema.json - LLM error codes:
docs/llm/error-codes.md
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file harnessgg_gimp-0.2.0.tar.gz.
File metadata
- Download URL: harnessgg_gimp-0.2.0.tar.gz
- Upload date:
- Size: 25.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
993069458b531463d5fc824f80408b60be85e53def534cc4de178cb43d2ab8fb
|
|
| MD5 |
6a75b7b249f1d9e37c65dcabf7f38ca7
|
|
| BLAKE2b-256 |
8e295968304792c0119000d96601f6b084dd3f555436d4c0f2e6b3248d56b559
|
Provenance
The following attestation bundles were made for harnessgg_gimp-0.2.0.tar.gz:
Publisher:
publish.yaml on Harnessgg/gimp
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
harnessgg_gimp-0.2.0.tar.gz -
Subject digest:
993069458b531463d5fc824f80408b60be85e53def534cc4de178cb43d2ab8fb - Sigstore transparency entry: 953454442
- Sigstore integration time:
-
Permalink:
Harnessgg/gimp@94fc9445fe8e7b61a57b60a226eb958e42baecce -
Branch / Tag:
refs/tags/v0.2.0 - Owner: https://github.com/Harnessgg
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yaml@94fc9445fe8e7b61a57b60a226eb958e42baecce -
Trigger Event:
release
-
Statement type:
File details
Details for the file harnessgg_gimp-0.2.0-py3-none-any.whl.
File metadata
- Download URL: harnessgg_gimp-0.2.0-py3-none-any.whl
- Upload date:
- Size: 25.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f888156a2f81140eb929f5deeccf82a1ffb590cc148b349e04d76b1126801449
|
|
| MD5 |
15e92106bc06b282f7742d7b3468284a
|
|
| BLAKE2b-256 |
e57169071c8254d5c3299f93c96279242d2cebf710cfd520e287d0accf0fc8eb
|
Provenance
The following attestation bundles were made for harnessgg_gimp-0.2.0-py3-none-any.whl:
Publisher:
publish.yaml on Harnessgg/gimp
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
harnessgg_gimp-0.2.0-py3-none-any.whl -
Subject digest:
f888156a2f81140eb929f5deeccf82a1ffb590cc148b349e04d76b1126801449 - Sigstore transparency entry: 953454444
- Sigstore integration time:
-
Permalink:
Harnessgg/gimp@94fc9445fe8e7b61a57b60a226eb958e42baecce -
Branch / Tag:
refs/tags/v0.2.0 - Owner: https://github.com/Harnessgg
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yaml@94fc9445fe8e7b61a57b60a226eb958e42baecce -
Trigger Event:
release
-
Statement type:
