Bundle

A Bundle plugin package is a collection of multiple plugins. It can package multiple plugins into one plugin to achieve batch installation effects while providing more powerful services.

You can package multiple plugins into a Bundle using the Dify CLI tool. Bundle plugin packages offer three types:

• Marketplace type: Stores plugin IDs and version information. During import, specific plugin packages are downloaded through the Dify Marketplace.
• GitHub type: Stores GitHub repository address, release version number, and asset filename. During import, Dify accesses the corresponding GitHub repository to download plugin packages.
• Package type: Plugin packages are stored directly in the Bundle. It doesn’t store reference sources but may cause large Bundle package sizes.

​

Prerequisites

• Dify plugin scaffolding tool
• Python environment, version ≥ 3.10;

For detailed instructions on preparing the plugin development scaffolding tool, please refer to Initializing Development Tools.

​

Create Bundle Project

In the current path, run the scaffolding command-line tool to create a new plugin package project:

./dify-plugin-darwin-arm64 bundle init

​

1. Enter Plugin Information

Follow the prompts to configure plugin name, author information, and plugin description. If you’re working in a team, you can also enter an organization name as the author.

The name must be 1-128 characters long and can only contain letters, numbers, hyphens, and underscores.

Fill in the information and hit enter, the Bundle plugin project directory will be created automatically.

​

2. Add Dependencies

• Marketplace

Execute the following command:

dify-plugin bundle append marketplace . --marketplace_pattern=langgenius/openai:0.0.1

Where marketplace_pattern is the plugin reference in the marketplace, format: organization-name/plugin-name:version

• Github

Execute the following command:

dify-plugin bundle append github . --repo_pattern=langgenius/openai:0.0.1/openai.difypkg

Where repo_pattern is the plugin reference in github, format: organization-name/repository-name:release/attachment-name

• Package

Execute the following command:

dify-plugin bundle append package . --package_path=./openai.difypkg

Where package_path is the plugin package directory.

​

Package Bundle Project

Run the following command to package the Bundle plugin:

dify-plugin bundle package ./bundle

After executing the command, a bundle.difybndl file will be automatically created in the current directory, which is the final packaging result.