Files
dify-docs/plugin-dev-en/0322-release-to-individual-github-repo.mdx
2025-07-16 16:42:34 +08:00

96 lines
3.8 KiB
Plaintext

---
dimensions:
type:
primary: operational
detail: deployment
level: intermediate
standard_title: Release to Individual GitHub Repo
language: en
title: Publish to Individual GitHub Repository
description: This document provides detailed instructions on how to publish Dify plugins
to a personal GitHub repository, including preparation work, initializing a local
plugin repository, connecting to a remote repository, uploading plugin files, packaging
plugin code, and the complete process of installing plugins via GitHub. This method
allows developers to fully manage their own plugin code and updates.
---
### Publish Methods
To accommodate the various publishing needs of developers, Dify provides three plugin publish methods:
#### **1. Marketplace**
**Introduction**: The official Dify plugin marketplace allows users to browse, search, and install a variety of plugins with just one click.
**Features**:
* Plugins become available after passing a review, ensuring they are **trustworthy** and **high-quality**.
* Can be installed directly into an individual or team **Workspaces**.
**Publication Process**:
* Submit the plugin project to the **Dify Marketplace** [code repository](https://github.com/langgenius/dify-plugins).
* After an official review, the plugin will be publicly released in the marketplace for other users to install and use.
For detailed instructions, please refer to:
<Card title="Publish to Dify Marketplace" icon="link" href="/en/plugins/publish-plugins/publish-to-dify-marketplace">
</Card>
#### 2. **GitHub Repository**
**Introduction**: Open-source or host the plugin on **GitHub** makes it easy for others to view, download, and install.
**Features**:
* Convenient for **version management** and **open-source sharing**.
* Users can install the plugin directly via a link, bypassing platform review.
**Publication Process**:
* Push the plugin code to a GitHub repository.
* Share the repository link, users can integrate the plugin into their **Dify Workspace** through the link.
For detailed instructions, please refer to:
<Card title="Publish Plugin on Personal GitHub Repository" icon="link" href="/en/plugins/publish-plugins/publish-plugin-on-personal-github-repo">
</Card>
#### Plugin File (Local Installation)
**Introduction**: Package the plugin as a local file (e.g., `.difypkg` format) and share it for others to install.
**Features**:
* Does not depend on an online platform, enabling **quick and flexible** sharing of plugins.
* Suitable for **private plugins** or **internal testing**.
**Publication Process**:
* Package the plugin project as a local file.
* Click **Upload Plugin** on the Dify plugin page and select the local file to install the plugin.
You can package the plugin project as a local file and share it with others. After uploading the file on the plugin page, the plugin can be installed into the Dify Workspace.
For detailed instructions, please refer to:
<Card title="Package and Publish Plugin File" icon="link" href="/en/plugins/publish-plugins/package-plugin-file-and-publish">
</Card>
### **Publication Recommendations**
* **Looking to promote a plugin** → **Recommended to use the Marketplace**, ensuring plugin quality through official review and increasing exposure.
* **Open-source sharing project** → **Recommended to use GitHub**, convenient for version management and community collaboration.
* **Quick distribution or internal testing** → **Recommended to use plugin file**, allowing for straightforward and efficient installation and sharing.
{/*
Contributing Section
DO NOT edit this section!
It will be automatically generated by the script.
*/}
---
[Edit this page](https://github.com/langgenius/dify-docs/edit/main/plugin-dev-en/0322-release-to-individual-github-repo.mdx) | [Report an issue](https://github.com/langgenius/dify-docs/issues/new?template=docs.yml)