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:

running returns plugin-owned state for the next check.
succeeded returns the final LLM result.
failed returns 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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dify_plugin-0.10.1.tar.gz (320.7 kB view details)

Uploaded Aug 5, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

dify_plugin-0.10.1-py3-none-any.whl (379.3 kB view details)

Uploaded Aug 5, 2026 Python 3

File details

Details for the file dify_plugin-0.10.1.tar.gz.

File metadata

Download URL: dify_plugin-0.10.1.tar.gz
Upload date: Aug 5, 2026
Size: 320.7 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for dify_plugin-0.10.1.tar.gz
Algorithm	Hash digest
SHA256	`875fe38d7a97d05fabb3b4f1ab467f2dc50ad2458a1eac68e6e212e29e7e1d29`
MD5	`b277fb44431dc91aeeb8baaed98c1fd5`
BLAKE2b-256	`2bbca8dd795c7dd33947a90a2832a7d32c6b7f5a771554cb3890369244d72331`

See more details on using hashes here.

Provenance

The following attestation bundles were made for dify_plugin-0.10.1.tar.gz:

Publisher: release.yml on langgenius/dify-plugin-sdks

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: dify_plugin-0.10.1.tar.gz
- Subject digest: 875fe38d7a97d05fabb3b4f1ab467f2dc50ad2458a1eac68e6e212e29e7e1d29
- Sigstore transparency entry: 2347244335
- Sigstore integration time: Aug 5, 2026
Source repository:
- Permalink: langgenius/dify-plugin-sdks@7f7aafd57439586403480bd4c16e7462fe3545b0
- Branch / Tag: refs/tags/v0.10.1
- Owner: https://github.com/langgenius
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: self-hosted
- Publication workflow: release.yml@7f7aafd57439586403480bd4c16e7462fe3545b0
- Trigger Event: push