ローカルソースコードからの起動
前提条件
Docker と Docker Compose のセットアップ
Dify をインストールする前に、マシンが以下の最小システム要件を満たしていることを確認してください:
- CPU >= 2 コア
- RAM >= 4 GiB
オペレーティングシステム | ソフトウェア | 説明 |
---|---|---|
macOS 10.14 以降 | Docker Desktop | Docker 仮想マシン(VM)が最低 2 つの仮想 CPU(vCPU)と 8 GB の初期メモリを使用するように設定してください。そうしないと、インストールが失敗する可能性があります。詳細については、Mac 用 Docker Desktop インストールガイドを参照してください。 |
Linux プラットフォーム | Docker 19.03 以降 Docker Compose 1.25.1 以降 | Docker と Docker Compose のインストール方法については、それぞれDocker インストールガイドとDocker Compose インストールガイドを参照してください。 |
WSL 2 が有効な Windows | Docker Desktop | Linux コンテナにバインドされるソースコードやその他のデータは、Windows ファイルシステムではなく Linux ファイルシステムに保存することをお勧めします。詳細については、Windows での WSL 2 バックエンドを使用した Docker Desktop インストールガイドを参照してください。 |
OpenAI TTS を使用する必要がある場合は、正常に機能するためにシステムに
FFmpeg
がインストールされている必要があります。詳細については、リンクを参照してください。
Dify リポジトリのクローン
git コマンドを実行して Dify リポジトリ をクローンします。
Docker Compose でミドルウェアを起動する
ストレージ用(PostgreSQL / Redis / Weaviate(ローカルで利用できない場合))や拡張機能用(Dify の sandbox や plugin-daemon サービスなど)の一連のミドルウェアが Dify バックエンドサービスで必要です。次のコマンドを実行して Docker Compose でミドルウェアを起動します:
バックエンドサービスのセットアップ
バックエンドサービスには以下が含まれます:
- API サービス:フロントエンドサービスと API アクセス用の API リクエストを提供
- Worker サービス:データセット処理、ワークスペース、クリーンアップなどの非同期タスクを提供
環境の準備
Python 3.12 が必要です。Python 環境をすばやくインストールするには pyenv の使用をお勧めします。
追加の Python バージョンをインストールするには、pyenv install を使用します。
「3.12」Python 環境に切り替えるには、次のコマンドを使用します:
API サービスの起動
-
api
ディレクトリに移動します: -
環境変数設定ファイルを準備します
-
ランダムな秘密鍵を生成し、.env ファイルの SECRET_KEY の値を置き換えます
-
依存関係のインストール
依存関係の管理には uv を使用します。
uv
で必要な依存関係をインストールするには、次のコマンドを実行します:macOS の場合:
brew install libmagic
で libmagic をインストールしてください。 -
データベースの移行を実行する
データベースを最新バージョンに移行します:
-
API サービスを起動する
期待される出力:
Worker サービスの起動
データセットファイルのインポートやデータセットドキュメントの更新などのキューからの非同期タスクを処理するには、以下の手順に従って Worker サービスを起動します
-
macOS または Linux の場合
Windows システムで Worker サービスを起動する場合は、代わりに次のコマンドを使用してください:
-
Windows の場合
期待される出力:
Web サービスのセットアップ
フロントエンドページ用の Web サービスを起動します。
環境の準備
Web フロントエンドサービスを起動するには、Node.js v22 (LTS) と PNPM v10 が必要です。
-
NodeJS のインストール
https://nodejs.org/en/download にアクセスし、v18.x 以上のお使いのオペレーティングシステム用のインストールパッケージを選択してください。一般的な使用には LTS バージョンをお勧めします。
-
PNPM のインストール
インストールガイド に従って PNPM をインストールします。または、以下のコマンドで
npm
を使用してpnpm
をインストールできます。
Web サービスの起動
-
web ディレクトリに移動します
-
依存関係をインストールします
-
環境変数設定ファイルを準備します
現在のディレクトリに
.env.local
というファイルを作成し、.env.example
の内容をコピーします。必要に応じてこれらの環境変数の値を変更します: -
Web サービスをビルドします
-
Web サービスを起動します
期待される出力:
Dify にアクセスする
ブラウザで http://127.0.0.1:3000 にアクセスして、Dify のすべての機能をお楽しみください。
乾杯!🍻