Dify Plugin Development Cheatsheet

​

Environment Requirements

• Python version ≥ 3.12
• Dify plugin scaffold tool (dify-plugin-daemon)

Learn more: Initializing Development Tools

​

Obtaining the Dify Plugin Development Package

Dify Plugin CLI

​

Installation Methods for Different Platforms

macOS Brew (Global Installation):

brew tap langgenius/dify
brew install dify

After installation, open a new terminal window and enter the dify version command. If it outputs the version information, the installation was successful.

macOS ARM (M Series Chips):

# Download dify-plugin-darwin-arm64
chmod +x dify-plugin-darwin-arm64
./dify-plugin-darwin-arm64 version

macOS Intel:

# Download dify-plugin-darwin-amd64
chmod +x dify-plugin-darwin-amd64
./dify-plugin-darwin-amd64 version

Linux:

# Download dify-plugin-linux-amd64
chmod +x dify-plugin-linux-amd64
./dify-plugin-linux-amd64 version

Global Installation (Recommended):

# Rename and move to system path
# Example (macOS ARM)
mv dify-plugin-darwin-arm64 dify
sudo mv dify /usr/local/bin/
dify version

​

Running the Development Package

Here we use dify as an example. If you are using a local installation method, please replace the command accordingly, for example ./dify-plugin-darwin-arm64 plugin init.

​

Plugin Development Process

​

1. Create a New Plugin

./dify plugin init

Follow the prompts to complete the basic plugin information configuration

Learn more: Dify Plugin Development: Hello World Guide

​

2. Run in Development Mode

Configure the .env file, then run the following command in the plugin directory:

python -m main

Learn more: Remote Debugging Plugins

​

4. Packaging and Deployment

Package the plugin:

cd ..
dify plugin package ./yourapp

Learn more: Publishing Overview

​

Plugin Categories

​

Tool Labels

Category tag class ToolLabelEnum(Enum)

class ToolLabelEnum(Enum):
    SEARCH = "search"
    IMAGE = "image"
    VIDEOS = "videos"
    WEATHER = "weather"
    FINANCE = "finance"
    DESIGN = "design"
    TRAVEL = "travel"
    SOCIAL = "social"
    NEWS = "news"
    MEDICAL = "medical"
    PRODUCTIVITY = "productivity"
    EDUCATION = "education"
    BUSINESS = "business"
    ENTERTAINMENT = "entertainment"
    UTILITIES = "utilities"
    OTHER = "other"

​

Plugin Type Reference

Dify supports the development of various types of plugins:

• Tool plugins: Integrate third-party APIs and services

  Learn more: Tool Plugin Development

• Model plugins: Integrate AI models

  Learn more: Model Plugin Introduction, Quick Integration of a New Model

• Agent Strategy plugins: Customize Agent thinking and decision-making strategies

  Learn more: Agent Strategy Plugins

• Extension plugins: Extend Dify platform functionality, such as Endpoints and WebAPP

  Learn more: Extension Plugins