Brushcue
Brushcue is a GPU-accelerated image editing library for Python. Every operation is a composable graph node — adjust color and tone, apply filters and blurs, composite images with a full set of blend modes, transform and crop, run ML-powered segmentation, or write custom GPU shaders. Chain nodes together and call .execute() once to run the whole pipeline.
Examples of things you can make
 |
 |
 |
 |
Install
pip install brushcue
If a GPU is not available on your system, a CPU-only build is also available. We recommend trying the standard brushcue package first — on many Linux environments, GPU emulation is supported and it will work without a physical GPU. If that is not an option, the CPU build can be used, though certain operations may fail without GPU support.
pip install brushcue-cpu
Documentation
The full documentation is available here.
Quickstart
import brushcue
ctx = brushcue.Context()
image = brushcue.load_composition("photo.png")
grayscale = brushcue.composition_grayscale(image)
result = grayscale.execute(ctx)
output_bytes = result.as_composition().to_image_bytes(ctx)
with open("output.png", "wb") as f:
f.write(bytes(output_bytes))
Examples
All the BrushCue tools are available as examples to learn how to use our API.
- Add Frame
- Adjust Channels
- Blue Channel
- Box Blur
- Brightness Adjust
- Brightness Contrast Adjust
- Camera Moving Distortion
- Chroma Offset
- Coachella Aesthetic
- Color Invert
- Color Rectangle
- Color Threshold
- Contrast Adjust
- Convert To BT 709
- Convert To Display P3
- Convert To sRGB
- CRT Monitor Filter
- Darken
- Desert Mirage Filter
- Duotone Effect
- Exposure Adjust
- Film Grain
- Film Noir
- Gaussian Blur
- Glitch Filter Animation
- Grayscale
- Green Channel
- Halftone
- High Contrast Grayscale
- Horizontal Mirror
- Image to Square with Blur
- Image to Video
- Kaleidoscope
- Kaleidoscope Animation
- Kelvin Tuner
- Lighten
- Lightness Threshold
- Linear Transform
- Liquify
- Median Filter
- Oval
- Pixelate
- Pixelate Reveal Animation
- Red Channel
- RGB Color Mix Aesthetic
- RGB Color Shift
- Rose Tint
- Rotate 180
- Rotate 90 Clockwise
- Rotate 90 Counter Clockwise
- Saturation Adjust
- Scale By Factor
- Sepia
- Shadow Tint
- Sharpen
- Shredder
- Sobel Edge Detection
- Solarize
- Sparkle Vignette
- Spinning Reveal Animation
- Swirl
- Vertical Mirror
- Vibrancy
- Vignette
- Warmth Adjust
- Zoom Blur
1 maintainer
Release files for brushcue-cpu 1.1.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| brushcue_cpu-1.1.5-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | CPython 3.11 | abi3 | Linux glibc 2.17+ x86-64 | Details |
| brushcue_cpu-1.1.5-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl | CPython 3.11 | abi3 | Linux glibc 2.17+ ARM64 | Details |
| brushcue_cpu-1.1.5-cp311-abi3-macosx_11_0_arm64.whl | CPython 3.11 | abi3 | macOS 11.0+ ARM64 | Details |
Total release size: 18.7 MB
Release files / brushcue_cpu-1.1.5-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | brushcue_cpu-1.1.5-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 6.7 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
b072d7bf8bc3cfaebd4adbc77ae10819c9b70fd3c048e3e47ae32c2f6c3dc7d1
|
|
BLAKE2b-256 checksum How to use checksums |
78c07ab9b115740c5e65d35dc255851fef7032ecf42a6d51537ed4d3835100ae
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 10, 2026.
Transparency logRelease files / brushcue_cpu-1.1.5-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | brushcue_cpu-1.1.5-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 6.6 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
12fab616feacd6aa5b3c59003b1bee54bad5436c564e3cead7d9b6c23cf4f945
|
|
BLAKE2b-256 checksum How to use checksums |
5e559bbb35fb8210dd85a9fe074dee2f1e51ef514440da14ca0ab1165a688e17
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 10, 2026.
Transparency logRelease files / brushcue_cpu-1.1.5-cp311-abi3-macosx_11_0_arm64.whl
| Download URL | brushcue_cpu-1.1.5-cp311-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 5.4 MB |
| Tags | CPython 3.11 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
7b28a41d8afda3e604b8e5349fd4715f4497c30ce7081c17bd9c45cc6f67a701
|
|
BLAKE2b-256 checksum How to use checksums |
1d5fc7551c2e33d2f34599e521f6d75b6db17a96a418c8eb8bcbf442b558e58b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 10, 2026.
Transparency log
