Skip to main content
A Bundle plugin package is a collection of multiple plugins packaged together, so users can install them all in one step. Use the Dify CLI tool to package multiple plugins into a Bundle. Bundle dependencies come in three types:
  • Marketplace: Stores the plugin’s ID and version. During import, Dify downloads the plugin package from the Dify Marketplace.
  • GitHub: Stores the GitHub repository address, release version number, and asset filename. During import, Dify downloads the plugin package from the corresponding GitHub repository.
  • Package: Stores the plugin package directly within the Bundle. No reference source is stored, but this can make the Bundle file larger.

​
Prerequisites

  • Dify plugin scaffolding tool
  • Python environment (version 3.12)
To set up the plugin development scaffolding tool, see Initialize Development Tools.

​
Create a Bundle Project

In the current directory, run the scaffolding command-line tool to create a new plugin package project: 
./dify-plugin-darwin-arm64 bundle init
If you have renamed the binary to dify and copied it to /usr/local/bin, run: 
dify bundle init

​
1. Fill in Plugin Information

Follow the prompts to configure the plugin name, author information, and plugin description. If you are collaborating as a team, you can also enter the organization name as the author.
The name must be 1–128 characters long and can only contain letters, numbers, hyphens, and underscores.
Bundle Basic Information
Press Enter, and the Bundle plugin project directory is created automatically.
Bundle Plugin Project Directory

​
2. Add Dependencies

​
Marketplace

dify-plugin bundle append marketplace . --marketplace_pattern=langgenius/openai:0.0.1
marketplace_pattern is the reference to the plugin in the Marketplace, in the format organization_name/plugin_name:version_number.

​
GitHub

dify-plugin bundle append github . --repo_pattern=langgenius/openai:0.0.1/openai.difypkg
repo_pattern is the reference to the plugin on GitHub, in the format organization_name/repository_name:release/asset_name.

​
Package

dify-plugin bundle append package . --package_path=./openai.difypkg
package_path is the path to the plugin package.

​
Package the Bundle Project

Run the following command to package the Bundle plugin: 
dify-plugin bundle package ./bundle
This creates a bundle.difybndl file in the current directory—the final packaged result.
Edit this page | Report an issue