貢献者ガイド
Difyに貢献したいと思っていることには素晴らしいと思います。私たちはあなたの貢献を心待ちにしております。スタッフも資金も限られた新興企業として、私たちはLLMアプリケーションの構築と管理のための最も直感的なワークフローを設計するという野心的な目標を持っています。そのため、コミュニティからのあらゆるサポートは貴重です。
我々の現状を考えると、柔軟かつ迅速に更新する必要がありますが、貢献者がスムーズに貢献できるようにしたいとも考えています。そのために、この貢献ガイドを作成しました。このガイドは、あなたがコードベースに慣れ、貢献者としての活動を迅速に開始できるようにすることを目的としています。
このガイドは、Dify自体と同様に、常に改善されています。時折プロジェクトの実態よりも遅れることがあるかもしれませんが、ご理解と改善のためのフィードバックを心から歓迎します。
ライセンスに関しては、時間を取って短いライセンスと貢献者協定を読んでください。また、コミュニティは行動規範にも従います。
始める前に
既存のイシューを探すか、新しいイシューを作成することができます。イシューは次の2つのカテゴリに分かれます:
機能リクエスト:
新しい機能リクエストを行う場合は、提案する機能の目的を説明し、できるだけ詳細なコンテキストを提供してください。@perzeusssが作成した優れた機能リクエスト助手を使ってドラフトを作成することもできます。ぜひ試してみてください。
既存のイシューから選びたい場合は、その下にコメントを残して意思を示してください。
関連するチームメンバーが関与します。うまくいけば、彼らがコーディングを開始することを承認します。それまでは、変更が提案される可能性があるため、作業を開始しないでください。
提案された機能が属する領域に応じて、異なるチームメンバーと連携する必要があります。以下は、各チームメンバーが現在取り組んでいる分野の概要です:
Member | Scope |
---|---|
Architecting Agents | |
RAG pipeline design | |
Building workflow orchestrations | |
Making our frontend a breeze to use | |
Developer experience, points of contact for anything | |
Overall product direction and architecture |
優先順位の判定ルール:
Feature Type | Priority |
---|---|
High-Priority Features as being labeled by a team member | High Priority |
Popular feature requests from our community feedback board | Medium Priority |
Non-core features and minor enhancements | Low Priority |
Valuable but not immediate | Future-Feature |
その他(例えばバグ報告、パフォーマンス向上、タイポ修正):
すぐにコーディングを開始してください。
優先順位の判定ルール:
Issue Type Priority Bugs in core functions (cannot login, applications not working, security loopholes)
Critical
Non-critical bugs, performance boosts
Medium Priority
Minor fixes (typos, confusing but working UI)
Low Priority
インストール
以下はDifyを開発用に設定する手順です:
1. リポジトリをフォークする
2. リポジトリをクローンする
ターミナルからフォークしたリポジトリをクローンします:
3. 依存関係を確認する
Difyは以下のツールとライブラリに依存しています:
Python バージョン 3.10.x
4. インストール
Difyはバックエンドとフロントエンドで構成されています。cd api/
を使ってバックエンドディレクトリに移動し、次はバックエンドREADMEに従ってインストールして下さい。別のターミナルでcd web/
を使ってフロントエンドディレクトリに移動し、そしてフロントエンドREADMEに従ってインストールして下さい。
一般的な問題とトラブルシューティングの手順についてはインストールFAQを参照してください。
5. ブラウザでDifyにアクセスする
設定を確認するため、ブラウザを開きhttp://localhost:3000(デフォルトまたはカスタムURLとポート)にアクセスします。これでDifyが動作しているはずです。
開発
モデルを追加提供する場合は、このガイドを参照してください。
エージェントやワークフローにツールを追加提供する場合は、このガイドを参照してください。
注意:新しいツールを提供したい場合は、必ずツールの YAML 説明ページに連絡先を残し、ドキュメントDify-docs のコードリポジトリに対応するPRを提出してください。
貢献する部分を迅速に理解できるように、以下にDifyのバックエンドとフロントエンドの簡単な注釈付きアウトラインを示します:
バックエンド
DifyのバックエンドはPythonで書かれており、Flaskフレームワークを使用しています。SQLAlchemyをORMとして使用し、Celeryをタスクキューとして使用しています。認証ロジックはFlask-loginで処理されます。
フロントエンド
このウェブサイトはNext.jsテンプレートを使用しており、スタイリングにはTailwind CSSを使用しています。React-i18nextを国際化に使用しています。
PRを提出する
最後に、私たちのリポジトリにプルリクエスト(PR)を提出する時が来ました。重要な機能の場合、最初に deploy/dev
ブランチにマージしてテストを行い、その後 main
ブランチにマージします。マージコンフリクトが発生した場合や、プルリクエストの提出方法が分からない場合は、GitHubのプルリクエストチュートリアルを参照してください。
これで完了です!あなたのPRがマージされると、あなたは私たちのREADMEに貢献者として掲載されます。
ヘルプを求める
貢献の過程で困難に直面したり質問がある場合は、関連するGitHubのイシューで質問を提出するか、私たちのDiscordに参加して迅速なコミュニケーションを行ってください。
Last updated