Dify Plugin SDK
A Python SDK for building plugins for Dify.
Here is a short introduction to Dify Plugin: https://docs.dify.ai/plugins/introduction
Development
This repository uses just as its command runner.
Install it with your preferred package manager, or with uv:
uv tool install rust-just
Common development commands:
just dev # Sync default dev dependencies
just fmt # Apply formatting fixes
just lint # Format and apply lint fixes
just check # Check lockfile, formatting, and linting
just test # Run SDK tests
just build # Build source and wheel distributions
just docs # Generate schema documentation
Production Plugin Examples
See langgenius/dify-official-plugins for production plugin implementations that are published and used by Dify.
LLM Polling Support
SDK 0.9.0 adds support for polling-based LLM invocation. A model can now
declare the polling feature and implement polling methods, allowing plugins
to submit long-running provider jobs and return later checks through a short
request/response flow.
Polling results use three states:
runningreturns plugin-owned state for the next check.succeededreturns the final LLM result.failedreturns a terminal error.
Version Management
This SDK follows Semantic Versioning (a.b.c):
- a: Major version - Indicates significant architectural changes or incompatible API modifications
- b: Minor version - Indicates new feature additions while maintaining backward compatibility
- c: Patch version - Indicates backward-compatible bug fixes
For SDK Users
When depending on this SDK, it's recommended to specify version constraints that:
- Allow patch and minor updates for bug fixes and new features
- Prevent major version updates to avoid breaking changes
Example in your project's dependency management:
dify_plugin >= 0.8
Manifest Version Reference
For the manifest specification, we've introduced two versioning fields:
meta.version- The version of the manifest specification, designed for backward compatibility. When installing an older plugin to a newer Dify, it's difficult to ensure breaking changes never occur, but at least Dify can detect them through this field. Once an unsupported version is detected, Dify will only use the supported parts of the plugin.meta.minimum_dify_version- The minimum version of Dify, designed for forward compatibility. When installing a newer plugin to an older Dify, many new features may not be available, but showing the minimum Dify version helps users understand how to upgrade.
Meta.Version Reference
| Manifest Version | Description |
|---|---|
| 0.0.2 | As ToolProviderType now supports mcp, an elder implementation is going to broken when user selected a mcp tool in Dify, so we bump it to 0.0.2 to ensure Dify knows that mcp is disabled if meta.version under 0.0.2. |
| 0.0.1 | Initial release |
Meta.MinimumDifyVersion Reference
| Minimum Dify Version | SDK Version | Description |
|---|---|---|
| 1.2.0 | 0.2.0 | Support fetching application info |
| 1.4.0 | 0.0.1-beta.49 | Support LLM multimodal output |
| 1.4.0 | 0.3.1 | Support OAuth functionality for plugins |
| 1.5.1 | 0.4.0 | Support dynamic-select parameter type |
| 1.5.1 | 0.4.0 | Support LLM structured output |
| 1.6.0 | 0.4.1 | Support dark-icon field in manifest |
| 1.7.0 | 0.4.2 | Support OAuth functionality for plugins |
| 1.8.1 | 0.4.4 | Support filename in MultiModalPromptMessageContent |
| 1.9.0 | 0.5.0 | Support Datasource functionality for plugins |
| 1.10.0 | 0.6.0 | Support Trigger functionality for plugins |
| 1.11.0 | 0.7.0 | Support Multimodal Reranking / Embeddings |
| 1.14.0 | 0.8.1 | Dependency and project structure cleanup |
| 1.14.2 | 0.9.0 | Support polling-based LLM plugin invocations |
2 maintainers
Metadata
2 maintainers
Release files for dify-plugin 0.10.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| dify_plugin-0.10.2.tar.gz | 320.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| dify_plugin-0.10.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 700.0 kB
Release files / dify_plugin-0.10.2.tar.gz
| Download URL | dify_plugin-0.10.2.tar.gz |
|---|---|
| Size | 320.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e37e707b3903c439cd09924b2125ba794ffdc886bfdbcb8f75db28ba64cb795b
|
|
BLAKE2b-256 checksum How to use checksums |
165a885909338df3e32604f45c579457c5dcfe982d35857994805735e5487d4b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 10, 2026.
Transparency logRelease files / dify_plugin-0.10.2-py3-none-any.whl
| Download URL | dify_plugin-0.10.2-py3-none-any.whl |
|---|---|
| Size | 379.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5a30db98cc4c3f36bdcc70ecd217b6bb37279c39fc0a843a985b05581dc461d3
|
|
BLAKE2b-256 checksum How to use checksums |
cf265897c50381eb23a10fd7ab770288d8656f3325d3407e4ee4f6fb7e70f76a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 10, 2026.
Transparency log
