---
title: "Compositor"
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/compositor
markdown: https://docs.nodetool.ai/nodes/nodetool/image/compositor.md
product: NodeTool
source: https://github.com/nodetool-ai/nodetool/blob/main/docs/nodes/nodetool/image/compositor.md
---

# Compositor

**Type:** `nodetool.image.Compositor`

**Namespace:** `nodetool.image`

## Description

Composite multiple image layers with per-layer opacity and blend mode.
    image, compositor, blend, layers, mask

## Properties

| Property | Type | Description | Default |
|----------|------|-------------|---------|
| layers | `list` | Per-layer state (positional): { opacity, blend_mode, visible, transform }. | `[]` |
| canvas_width | `int` | Composite canvas width in pixels. 0 → use the first visible layer's width. | `0` |
| canvas_height | `int` | Composite canvas height in pixels. 0 → use the first visible layer's height. | `0` |

## Outputs

| Output | Type | Description |
|--------|------|-------------|
| output | `image` |  |

## Related Nodes

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