---
title: "Painter"
description: "Local-first visual environment for building and running AI workflows. Build agents visually, deploy anywhere, privacy by design."
canonical: https://docs.nodetool.ai/nodes/nodetool/image/painter
markdown: https://docs.nodetool.ai/nodes/nodetool/image/painter.md
product: NodeTool
source: https://github.com/nodetool-ai/nodetool/blob/main/docs/nodes/nodetool/image/painter.md
---

# Painter

**Type:** `nodetool.image.Painter`

**Namespace:** `nodetool.image`

## Description

Paint an alpha mask on top of an image and output the mask.
    image, painter, mask, brush, paint

## Properties

| Property | Type | Description | Default |
|----------|------|-------------|---------|
| image | `image` | Source image painted on (passed through to output). | `{"type":"image","uri":"","asset_id":null,"data"...` |
| mask_data | `str` | Base64-encoded PNG of the painted alpha mask. Managed by the UI. | `` |
| canvas_width | `int` | Width of the paint canvas in pixels. Overwritten by the source image's width when an image is set. | `512` |
| canvas_height | `int` | Height of the paint canvas in pixels. Overwritten by the source image's height when an image is set. | `512` |

## Outputs

| Output | Type | Description |
|--------|------|-------------|
| mask | `image` |  |
| image | `image` |  |

## Related Nodes

Browse other nodes in the [nodetool.image](./) namespace.