From 14edb8b5f31a36e1c0f1cfe8276e5c45ec380c70 Mon Sep 17 00:00:00 2001
From: Nansike <nansike@outlook.com>
Date: Wed, 13 Aug 2025 12:20:41 +0800
Subject: [PATCH 1/2] Add Japanese and English versions of gpt-oss deployment
 doc.

---
 docs.json                                     |  10 +-
 ...s Local Deployment with Ollama and Dify.md | 130 ++++++++++++++++++
 ...¼‹Dify ã�«ã‚ˆã‚‹ gpt-oss ã�®ãƒ­ãƒ¼ã‚«ãƒ«ãƒ‡ãƒ—ロイ.md |  99 +++++++++++++
 3 files changed, 236 insertions(+), 3 deletions(-)
 create mode 100644 en/development/models-integration/gpt-oss Local Deployment with Ollama and Dify.md
 create mode 100644 ja-jp/development/models-integration/Ollama＋Dify �よる gpt-oss �ローカルデプロイ.md

diff --git a/docs.json b/docs.json
index 4d2037f6..3309a4b7 100644
--- a/docs.json
+++ b/docs.json
@@ -12,6 +12,7 @@
         "light": "https://assets-docs.dify.ai/2025/05/d05cfc6ebe48f725d171dc71c64a5d16.svg",
         "dark": "https://assets-docs.dify.ai/2025/05/c51f1cda47c1d9a4a162d7736f6e4c53.svg"
     },
+    
     "navigation": {
         "versions": [
             {
@@ -388,7 +389,8 @@
                                             "en/development/models-integration/ollama",
                                             "en/development/models-integration/litellm",
                                             "en/development/models-integration/gpustack",
-                                            "en/development/models-integration/aws-bedrock-deepseek"
+                                            "en/development/models-integration/aws-bedrock-deepseek",
+                                            "en/development/models-integration/gpt-oss-local-deployment"
                                         ]
                                     },
                                     {
@@ -1048,7 +1050,8 @@
                                             "zh-hans/development/models-integration/ollama",
                                             "zh-hans/development/models-integration/litellm",
                                             "zh-hans/development/models-integration/gpustack",
-                                            "zh-hans/development/models-integration/aws-bedrock-deepseek"
+                                            "zh-hans/development/models-integration/aws-bedrock-deepseek",
+                                            "zh-hans/development/models-integration/gpt-oss-local-deployment"
                                         ]
                                     },
                                     {
@@ -1691,7 +1694,8 @@
                                             "ja-jp/development/models-integration/ollama",
                                             "ja-jp/development/models-integration/litellm",
                                             "ja-jp/development/models-integration/gpustack",
-                                            "ja-jp/development/models-integration/aws-bedrock-deepseek"
+                                            "ja-jp/development/models-integration/aws-bedrock-deepseek",
+                                            "ja-jp/development/models-integration/gpt-oss-local-deployment"
                                         ]
                                     },
                                     {
diff --git a/en/development/models-integration/gpt-oss Local Deployment with Ollama and Dify.md b/en/development/models-integration/gpt-oss Local Deployment with Ollama and Dify.md
new file mode 100644
index 00000000..0218c9b8
--- /dev/null
+++ b/en/development/models-integration/gpt-oss Local Deployment with Ollama and Dify.md	
@@ -0,0 +1,130 @@
+---
+title: " gpt-oss Local Deployment with Ollama and Dify "
+---
+# I. Introduction
+
+The gpt-oss series is an open-source model first released by OpenAI in August 2025.
+
+> gpt-oss:20b (fits systems with ~16 GB memory)
+>
+> gpt-oss:120b (designed for ≥ 60 GB memory)
+
+You can run it locally with Ollama. No cloud calls. Data stays on your machine, which helps with privacy and latency.
+
+Dify is an open-source platform for building AI Agents and Workflows. This guide shows how to run gpt-oss with Ollama and plug it into Dify for a private, high-performance setup.
+
+* * *
+
+# II. Environment Setup
+
+## Step 1: Run gpt-oss with Ollama
+
+1.  Install Ollama
+    
+
+[Download](https://ollama.com/) and install for macOS, Windows, or Linux. If anything is unclear, see the [official docs](https://docs.dify.ai/en/development/models-integration/ollama#integrate-local-models-deployed-by-ollama).
+
+  
+
+2.  Pull a model
+    
+
+```Bash
+# Recommended for most dev machines
+ollama pull gpt-oss:20b
+
+# For large GPUs or multi-GPU hosts
+ollama pull gpt-oss:120b
+```
+
+Both models are pre‑quantized in **MXFP4** , suitable for local deployment.
+
+  
+
+3.  Start Ollama
+    
+
+The default endpoint is http://localhost:11434.
+
+## Step 2: Install Dify locally
+
+See the [Dify docs](https://docs.dify.ai/en/getting-started/install-self-hosted/readme) for full instructions. Or follow the quick tutorial below.
+
+### Prerequisites
+
+Install [Docker](https://www.docker.com/products/docker-desktop/) and make sure Docker Engine is running.
+
+![1](https://raw.githubusercontent.com/NanSike/image-host/main/images/1.png)
+
+
+
+### Install steps
+
+```Bash
+git clone https://github.com/langgenius/Dify.git
+cd Dify/docker
+cp .env.example .env
+docker compose up -d
+```
+
+![2](https://raw.githubusercontent.com/NanSike/image-host/main/images/2.png)
+
+Open your local Dify instance and complete the initial setup.
+
+![3](https://raw.githubusercontent.com/NanSike/image-host/main/images/3.png)
+
+# III. Add the model and test chat
+
+1.  In **Settings → Model Providers → Ollama** , click **Add Ollama model type** .
+    
+
+![4](https://raw.githubusercontent.com/NanSike/image-host/main/images/4.png)  
+
+2.  Set **Base URL** to `http://localhost:11434`, select **Model name** `gpt-oss:20b`, and fill in the required fields.
+    
+
+![5](https://raw.githubusercontent.com/NanSike/image-host/main/images/5.png)
+
+  
+
+3.  Create a blank template
+    
+
+![6](https://raw.githubusercontent.com/NanSike/image-host/main/images/6.png)
+
+  
+
+4.  Select the app or workflow type you want to build.
+    
+
+![7](https://raw.githubusercontent.com/NanSike/image-host/main/images/7.png)
+
+* * *
+
+# IV. Verification and Usage
+
+*   On Dify’s **model testing** page, send a prompt and check that the response looks correct.
+    
+*   In a workflow, add an **LLM** node, select `gpt-oss:20b`, and connect the nodes end to end.
+    
+
+![8](https://raw.githubusercontent.com/NanSike/image-host/main/images/8.png)
+
+![9](https://raw.githubusercontent.com/NanSike/image-host/main/images/9.png)
+
+* * *
+
+# V. Appendix — FAQ and tips
+
+**Model Pull Is Slow**
+
+*   *Configure a Docker proxy or use an image mirror to speed up downloads.*
+    
+
+**Insufficient GPU Memory**
+
+*   *Use* *`gpt-oss:20b`*. You can enable CPU offloading, but responses will be slower.*
+
+**Port Access Issues**
+
+*   *Check firewall rules, port bindings, and Docker network settings to ensure connectivity.*
\ No newline at end of file
diff --git a/ja-jp/development/models-integration/Ollama＋Dify �よる gpt-oss �ローカルデプロイ.md b/ja-jp/development/models-integration/Ollama＋Dify �よる gpt-oss �ローカルデプロイ.md
new file mode 100644
index 00000000..b56c5a3b
--- /dev/null
+++ b/ja-jp/development/models-integration/Ollama＋Dify �よる gpt-oss �ローカルデプロイ.md	
@@ -0,0 +1,99 @@
+---
+title: " Ollama＋Dify �よる gpt-oss �ローカルデプロイ"
+---
+
+## ����
+
+gpt-ossシリーズ��2025年8月�OpenAI�らリリース�れ�オープンソースモデル��。
+- gpt-oss:20b（約16GB�メモリを��システム��）
+- gpt-oss:120b（60GB以上�メモリ�対応）
+
+ローカル�Ollamaを使用��実行����。クラウド呼�出������データ�常�ローカル��存�れ�プライ�シー�護�低�延�貢献���。
+
+Dify�AIエージェントやワークフローを構築�る���オープンソースプラットフォーム��。��ガイド���Ollamaを使��gpt-ossを実行��Dify�接続��プライベート��高性能�設定を行�方法を示���。
+
+## 環境�セットアップ
+
+### ステップ1：Ollama�gpt-ossを実行�る
+
+**1. Ollamaをインストール**
+
+[Ollama�公�サイト](https://ollama.com/)を通��macOS�Windows����Linux用�ダウンロード��インストール������。
+
+**2. gpt-ossモデルをインストール**
+
+```Bash
+# 開発マシン用�����
+ollama pull gpt-oss:20b
+
+# 大�模GPU���マル�GPUホスト用�����
+ollama pull gpt-oss:120b
+```
+
+�れら�モデル����混�精度フォーマット（MXFP4）���化�れ��り�ローカルデプロイ�������。
+
+**3. Ollama�起動**
+
+デフォルト�エンド�イント�http://localhost:11434��。
+
+### ステップ2：Difyをローカル�インストール
+
+Dify�[公�ドキュメント](https://docs.dify.ai/ja-jp/getting-started/install-self-hosted/readme)�完全�手順��り��。も�����ら�シンプル��ュートリアルを�覧����。
+
+**���件**
+[Docker](https://www.docker.com/products/docker-desktop/)をインストール��Dockerエンジン�正常�動作���る��を確�������。
+
+![1](https://raw.githubusercontent.com/NanSike/image-host/main/images/1.png)
+
+**インストール手順**
+
+```Bash
+git clone https://github.com/langgenius/Dify.git
+cd Dify/docker
+cp .env.example .env
+docker compose up -d
+```
+
+![2](https://raw.githubusercontent.com/NanSike/image-host/main/images/2.png)
+
+ローカルDifyインスタンスを開���期設定を完了�������。
+
+![3](https://raw.githubusercontent.com/NanSike/image-host/main/images/3.png)
+
+## モデル�追加��ャット�テスト
+
+1. **設定 > モデルプロ�イダー > Ollama** �移動��**「Ollamaモデルタイプを追加�**をクリック������。
+
+![4](https://raw.githubusercontent.com/NanSike/image-host/main/images/4.png)
+
+2. 基本URLを`http://localhost:11434`�設定��モデル��`gpt-oss`を�択��必��フィールドを埋������。
+
+![5](https://raw.githubusercontent.com/NanSike/image-host/main/images/5.png)
+
+3. 空�テンプレートを作����。
+
+![6](https://raw.githubusercontent.com/NanSike/image-host/main/images/6.png)
+
+4. 構築���アプリ�タイプを�択������。
+
+![7](https://raw.githubusercontent.com/NanSike/image-host/main/images/7.png)
+
+## 検証�使用
+
+- Dify�**モデルテスト**ページ�プロンプトを�信��応答�期待通り��る��を確�������。
+- ワークフロー�**LLMノード**を追加��`gpt-oss:20b`を�択��ノードをエンドツーエンド�接続������。
+
+![8](https://raw.githubusercontent.com/NanSike/image-host/main/images/8.png)
+
+![9](https://raw.githubusercontent.com/NanSike/image-host/main/images/9.png)
+
+## よ��る質�
+
+1. モデル�ダウンロード���
+   ダウンロードを高速化�る����Dockerプロキシを設定�る��イメージミラーを使用������。
+
+2. GPUメモリ�足
+   `gpt-oss:20b`を使用������。CPUオフローディングを有効��る��も��������場��応答����り��。
+
+3. �ートアクセス��題
+   接続を確��る����ファイアウォール�ルール��ート��インディング��よ�Docker�ットワーク設定を確�������。
\ No newline at end of file

From 0bab2ead93d0ba502950fd3c8b5dfab478fd2e2c Mon Sep 17 00:00:00 2001
From: Nansike <nansike@outlook.com>
Date: Wed, 13 Aug 2025 14:25:34 +0800
Subject: [PATCH 2/2] Add Chinese document

---
 .../models-integration/gpt-oss + Ollama.md    | 152 ++++++++++++++++++
 1 file changed, 152 insertions(+)
 create mode 100644 zh-hans/development/models-integration/gpt-oss + Ollama.md

diff --git a/zh-hans/development/models-integration/gpt-oss + Ollama.md b/zh-hans/development/models-integration/gpt-oss + Ollama.md
new file mode 100644
index 00000000..7ddc12f2
--- /dev/null
+++ b/zh-hans/development/models-integration/gpt-oss + Ollama.md	
@@ -0,0 +1,152 @@
+---
+title: " gpt-oss + Ollama 本地化部署指� "
+---
+# 一�引言
+
+*   gpt-oss 系列是 OpenAI 于 2025 年 8 月首次�布的开�模型。
+    
+
+> gpt-oss:20b（适用于约 16GB 的内存）
+> 
+> gpt-oss:120b（适用于≥ 60GB 的内存）
+
+*   使用 Ollama 在本地部署，无需�云端�� API 请求。数�始终在本地�行，适用于对��和�应速度有�求的场景。
+    
+*   Dify 是一个开�的 LLM 应用平�，支�集�本地模型�快速构建 AI 应用程�和 RAG �程。
+    
+
+**目标：** 展示如何使用 Ollama 在本地部署 gpt-oss 并将其集�到 Dify 中，以构建一个�有且安全的 LLM �务。
+
+* * *
+
+# **二�环境准备**
+
+## **第一步：使用 Ollama 本地部署 gpt-oss 模型**
+
+1.  安装 Ollama
+    
+
+访问 [Ollama 官网](https://ollama.com)下载安装，根��作系统选择 macOS�Windows 或 Linux 版本。
+
+  
+
+2.  拉� gpt-oss 模型
+    
+
+*   gpt-oss:20b（推�日常开�机器，需 ≥ 16 GB 显存或统一内存） `ollama pull gpt-oss:20b`
+    
+
+  
+
+*   gpt-oss:120b（需 ≥ 60 GB 显存或多 GPU 支�） `ollama pull gpt-oss:120b`
+    
+
+这两个模型�默认已�化为 MXFP4 格�，适�大多数本地部署场景
+
+  
+
+3.  �动 Ollama �务
+    
+
+�务默认监�在： http://localhost:11434。
+
+  
+
+## **第二步：本地部署 Dify 并准备接入**
+
+详细内容�考Dify[官方文档](https://docs.dify.ai/zh-hans/getting-started/install-self-hosted/readme)，也�以�考如下简易教程。
+
+### �置�件
+
+下载安装[Docker](https://www.docker.com/products/docker-desktop/) 环境，安装完毕�确认 Docker Engine 能正常�行。
+
+![1](https://raw.githubusercontent.com/NanSike/image-host/main/images/1.png)
+
+
+  
+
+### 本地部署Dify
+
+1.  使用Git克隆
+    
+
+`git clone` `https://github.com/langgenius/Dify.git`
+
+  
+
+2.  进入 Dify �代�的 docker 目录，执行一键�动命令：
+    
+
+`cd Dify/docker` `cp .env.example .env` `d`ouyin
+
+![2](https://raw.githubusercontent.com/NanSike/image-host/main/images/2.png)
+
+3.  进入本地 Dify，填写相关信�
+    
+
+![3](https://raw.githubusercontent.com/NanSike/image-host/main/images/3.png)
+
+* * *
+
+# **三�添加模型并测试�天接�**
+
+1.  点击页��上角的设置，进入�选择模型�供商，点击添加 Ollama 模型类型： **Settings > Model Providers > Ollama**
+    
+
+![4](https://raw.githubusercontent.com/NanSike/image-host/main/images/4.png)  
+
+  
+
+2.  请填写 ollama 的相关信�。将 **“gpt-oss:20b�** 选作模型�称。如有任何�清楚的地方，您�以�考官方详细的[部署文档](https://docs.dify.ai/en/development/models-integration/ollama#integrate-local-models-deployed-by-ollama)��作 ollama。
+    
+
+![5](https://raw.githubusercontent.com/NanSike/image-host/main/images/5.png)
+
+  
+
+3.  新建空白模�
+    
+
+![6](https://raw.githubusercontent.com/NanSike/image-host/main/images/6.png)
+
+  
+
+4.  选择您想创建的类型
+    
+
+![7](https://raw.githubusercontent.com/NanSike/image-host/main/images/7.png)
+
+* * *
+
+# **四�验�与使用**
+
+*   在 Dify 的模型测试页�中，输入适当的�示语，并确认模型的�应符�您的预期。
+    
+*   在您的应用�程中添加一个简�的 LLM 节点，选择 gpt-oss:20b 作为模型，并确�整个工作�程连接无误。
+    
+
+![8](https://raw.githubusercontent.com/NanSike/image-host/main/images/8.png)
+
+![9](https://raw.githubusercontent.com/NanSike/image-host/main/images/9.png)
+
+
+* * *
+
+# **五�附录**
+
+**常�问题�建议**
+
+*   **模型下载速度慢**
+    
+
+�示：�置 Docker 代�或使用图�加速�务以加快下载速度。
+
+*   **GPU 内存�足**
+    
+
+�示：对于 GPU 内存有�的设备，请使用 gpt-oss：20b。您还�以�用 CPU 转�功能，但这样会导致�应速度�慢。
+
+*   **端�访问问题**
+    
+
+�示：检查防�墙规则�端�绑定和 Docker 网络设置，以确�连接正常。
\ No newline at end of file