Image Merge

image-merge

Author: wuyingfeng
Version: 0.0.2
Type: tool
Source repository: https://github.com/wuyingfeng1998/image-merge-dify-plugin

Description

Merge multiple JPG/PNG images into a single image. Images are stacked vertically in the order of the input file list, so the first file appears at the top and the last file at the bottom.

Setup

No credentials or API keys are required. Runtime dependencies are and , pinned in .

Usage

Install the plugin in Dify from the marketplace, or from a local package ().
Add the Merge Images Vertically tool to a Workflow / Chatflow tool node, or use it in an Agent.
Fill in the parameters:

Parameter	Required	Description
Image files ()	Yes	Ordered list of JPG/PNG images. The merge order follows the list order (top to bottom).
Gap ()	No	Vertical spacing in pixels between adjacent images. Default .
Background color ()	No	Fills padding and transparent areas, e.g. or . Default .

The wider image defines the canvas width; narrower images are centered horizontally. The tool outputs one PNG file plus , and variables.

Notes

Only JPG/JPEG and PNG inputs are supported; other formats raise an error.
EXIF orientation of photos is applied before merging.
The merged canvas is limited to 100 megapixels to protect the plugin runner's memory (the manifest requests 1 GB).

Building a fully offline package

produces a self-contained for hosts without internet access. It downloads every dependency as a Linux x86_64 / CPython 3.12 wheel into , points at that local wheelhouse, and adds the matching configuration:

The resulting package installs and starts on a Linux x86_64 Dify plugin daemon with no network access. Dependencies are still installed by the daemon at install time, but only from the bundled wheels.