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
Documentation
The full documentation is available here.
Quickstart
import brushcue
ctx = brushcue.Context()
image = brushcue.Composition.load("photo.png")
grayscale = image.grayscale()
composition = grayscale.execute(ctx)
output_bytes = composition.to_image_bytes(ctx)
with open("output.png", "wb") as f:
f.write(output_bytes)
Examples
The following BrushCue tools have Python examples. Browse the notebooks in examples/ or open the rendered examples below to learn how to use the API.
- 16:9 Crop
- 1950s Filter
- 1960s Filter
- 1970s Filter
- 1980s Filter
- 1990s Filter
- 2000s Filter
- 2010s Filter
- 4:5 Crop
- 9:16 Crop
- Add Frame
- Adjust Channels
- Afternoon Filter
- Amber Plains
- Auto Contrast
- Autumn Filter
- Black and White Negative Filter
- Bloom
- Blue Channel
- Blue Hour Filter
- Blur Reveal Animation
- Box Blur
- Brightness Adjust
- Brightness Contrast Adjust
- Camera Moving Distortion
- Canopy Light
- Cartoon Filter
- Channel Mixer
- Chroma Offset
- Circle Area
- Circle Crop
- Coachella Aesthetic
- Color Gradient
- Color Invert
- Color Rectangle
- Color Reducer
- Color Threshold
- Conic Gradient
- Contrast Adjust
- Convert to BT.709
- Convert to Display P3
- Convert to sRGB
- Coquette Filter
- Cosine (Degrees)
- Cosine (Radians)
- Cottagecore Filter
- Cross Process Filter
- CRT Monitor Filter
- Custom Color Shader
- Custom Spacial Shader
- Cyan Nocturne
- Cyberpunk Filter
- Dark Academia Filter
- Darken
- Dawn Filter
- Degrees to Radians
- Desert Frame
- Desert Mirage Filter Animation
- Dilate
- Dithering Effect
- Drift Animation
- Duotone Effect
- Ellipse Area
- Ember Rock
- Emboss
- Erode
- Exposure Adjust
- Fade Filter
- Faded Postcard
- Film Grain
- Film Noir
- Fisheye
- Frost Line
- Gamma Adjust
- Gaussian Blur
- Glitch Filter Animation
- Golden Hour Filter
- Grayscale
- Grayscale Gradient
- Green Channel
- Grunge Filter
- Halftone
- High Contrast Grayscale
- Honey Hour
- Horizontal Mirror
- Hue Adjust
- Image Resizer
- Image to Video
- Indie Sleaze Filter
- Kaleidoscope
- Kaleidoscope Animation
- Kelvin Tuner
- Light Leak
- Lighten
- Lightness Threshold
- Linear Transform
- Liquify
- Matte Filter
- Median Filter
- Midnight Filter
- Milk Glass
- Morning Filter
- Negative Filter
- Noon Filter
- Old Money Filter
- Opacity Scale
- Parallelogram Area
- Peachfeed
- Pencil Sketch
- Petal Haze
- Pixelate
- Pixelate Reveal Animation
- Powder Blue
- Pythagorean Theorem
- Radial Gradient
- Radians to Degrees
- Rectangle Area
- Red Channel
- Reef Current
- RGB Color Mix Aesthetic
- RGB Color Shift
- Riviera Pop
- Rose Replay
- Rose Tint
- Rotate & Straighten
- Rotate 180°
- Rotate 90° Clockwise
- Rotate 90° Counter-Clockwise
- Salt Flat
- Saturation Adjust
- Scale by Factor
- Scan Lines
- Sepia
- Shadow Tint
- Sharpen
- Silverpine 800
- Sine (Degrees)
- Sine (Radians)
- Sobel Edge Detection
- Solarize
- Solpeach 400
- Sootline Mono
- Spinning Reveal Animation
- Spring Filter
- Square Area
- Square Crop
- Star Cut Out
- Static Noise
- Summer Filter
- Summit Air
- Sunday 76
- Sunset Filter
- Swirl
- Terracotta Sun
- Tint Toward Color
- Trapezoid Area
- Triangle Area
- Tropic Chrome
- Vaporwave Filter
- Verdant Mist
- Vertical Mirror
- Vibrancy
- Vignette
- Vintage Filter
- Warmth Adjust
- Watercolor Effect
- Whiten Image
- Winter Filter
- Y2K Filter
- Zoom Blur
1 maintainer
Metadata
1 maintainer
Release files for brushcue 1.4.15
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Actions Reset | |||
|---|---|---|---|---|
| brushcue-1.4.15-cp311-abi3-win_amd64.whl | CPython 3.11 | abi3 | Windows x86-64 | Details for brushcue-1.4.15-cp311-abi3-win_amd64.whl |
| brushcue-1.4.15-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl | CPython 3.11 | abi3 | Linux glibc 2.17+ x86-64 | Details for brushcue-1.4.15-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl |
| brushcue-1.4.15-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl | CPython 3.11 | abi3 | Linux glibc 2.17+ ARM64 | Details for brushcue-1.4.15-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl |
| brushcue-1.4.15-cp311-abi3-macosx_11_0_arm64.whl | CPython 3.11 | abi3 | macOS 11.0+ ARM64 | Details for brushcue-1.4.15-cp311-abi3-macosx_11_0_arm64.whl |
Total release size: 36.9 MB
Release files / brushcue-1.4.15-cp311-abi3-win_amd64.whl
| Download URL | brushcue-1.4.15-cp311-abi3-win_amd64.whl |
|---|---|
| Size | 8.8 MB |
| Tags | CPython 3.11 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
2357f38f247e949857f5d57eb2ee8b1ebad9adb1450e7fc8d33f83e63f2e4881
|
|
BLAKE2b-256 checksum How to use checksums |
ee4da4548059fd2b1f0f18707d1b0d698e04b97e0ee1369fc009392bc82afd1c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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 Nov 10, 2026.
Transparency logRelease files / brushcue-1.4.15-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
| Download URL | brushcue-1.4.15-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl |
|---|---|
| Size | 9.9 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
51320a07a198eabf918e255000e073517e1f4a6a8e8a98190883e54e6d466fdd
|
|
BLAKE2b-256 checksum How to use checksums |
b68b86bcb2868c1264a2015edd2215d27660d8126d49650c67ceddb84124f20f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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 Nov 10, 2026.
Transparency logRelease files / brushcue-1.4.15-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
| Download URL | brushcue-1.4.15-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl |
|---|---|
| Size | 10.1 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
696aeab8d4381cd933eb4ceb9c141c856274506b6c665c3b013c4c7d2fa0189f
|
|
BLAKE2b-256 checksum How to use checksums |
1595d8af26ba26d0c3ff79a94e27d816f6b45c7c49ffec4f51ad5247a3bdada2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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 Nov 10, 2026.
Transparency logRelease files / brushcue-1.4.15-cp311-abi3-macosx_11_0_arm64.whl
| Download URL | brushcue-1.4.15-cp311-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 8.0 MB |
| Tags | CPython 3.11 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
d8aab829342716b88b39142757206774369631bd25685c9b1eccc0427910cd4d
|
|
BLAKE2b-256 checksum How to use checksums |
578a9c667f80985a411c11a1395ae23a53a33b13208b92402204465f55284d0c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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 Nov 10, 2026.
Transparency logSecurity for brushcue 1.4.15
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.
Full provenance
All 4 files in this release have been uploaded with provenance metadata.
Attestation for brushcue-1.4.15-cp311-abi3-win_amd64.whl
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 Nov 10, 2026.
Transparency logA 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.
