---
id: dify-plugin
version: "0.10.2"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# dify-plugin — Dify Plugin SDK

License: permissive · Maintenance: active · Downloads: 4.7M/mo

## What it is and what it does

Dify Plugin SDK is a framework for writing plugins that integrate with Dify, an open-source platform for building LLM applications. The SDK provides Python abstractions for declaring and implementing plugin capabilities—tools, LLM providers, datasources, and triggers—along with manifest specifications that tell Dify what your plugin offers. It handles request/response marshalling, authentication, and long-running job polling for LLM invocations.

The SDK is tightly coupled to Dify's versioning: each SDK release targets a specific minimum Dify version, and the manifest includes version fields so Dify can detect compatibility mismatches at install time. You write plugin code using the SDK's class-based interfaces, declare your plugin's capabilities in a manifest, and Dify loads and invokes your code through a well-defined protocol. The SDK is actively maintained and follows semantic versioning, so patch and minor updates are safe but major versions may break your plugin code.

Use it for:

- Build a custom LLM provider plugin to integrate a proprietary language model into Dify's agent workflows.
- Create a datasource plugin that connects Dify to an internal database or API for live data queries.
- Develop a tool plugin that wraps a third-party service so Dify agents can call it as an action.
- Implement a trigger plugin to let Dify workflows respond to external events.
- Build a reranking or embedding plugin to swap in custom models for semantic search in Dify retrieval pipelines.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Python SDK for building plugins that extend Dify with tools, datasources, triggers, and LLM providers.

Yes, if you are building plugins for Dify. The SDK is actively maintained, has no known vulnerabilities, installs with low friction, and is licensed permissively. The main constraint is Python 3.12 or later and ensuring your plugin's manifest version matches the Dify instance you are targeting.

## Install

pip install dify-plugin
uv add dify-plugin
poetry add dify-plugin

## Installing dify-plugin

Before you install: Low friction installation with a pure Python wheel. Actively maintained with a release 4 days ago. Requires Python 3.12 or later.

License in practice: Licensed under Apache-2.0 (permissive), allowing use in commercial and proprietary projects with minimal restrictions beyond attribution and license inclusion.

Quickstart:

pip install dify-plugin==0.10.2

from dify_plugin import ToolProvider

class MyTool(ToolProvider):
    def invoke(self, tool_name, tool_input):
        return {"result": "output"}

Requires Python 3.12 or later

Verify before relying:

- Whether the 13 runtime dependencies introduce any transitive security concerns beyond what OSV reports for dify-plugin itself
- Stability guarantees for the plugin API across minor version updates, given the semantic versioning policy described

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 4.7M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

dify plugin development, llm plugin sdk, dify extension framework, build dify plugins, dify tool provider, plugin sdk for dify, dify datasource plugin, llm-plugin, dify-ecosystem, plugin-framework

[View on SkillFed](https://skillfed.io/packages/dify-plugin) · [View on PyPI](https://pypi.org/project/dify-plugin/)