4-o-ghibli-at-home：ローカルで動作するジブリ風画像変換ツール

4o-ghibli-at-homeは、ユーザーがアップロードした画像をスタジオジブリ風のアートワークに変換することに焦点を当てたオープンソースのAI画像スタイル変換ツールです。FLUX.1-Kontext-devとDFloat11モデルを使用し、データのプライバシーを確保するためにローカルデバイス上で動作します。ユーザーはログインする必要も、クラウドサービスに依存する必要もなく、画像処理はすべてローカルで行われる。このツールは、ジブリスタイルが好きなクリエイターやアニメファンに適しており、普通の写真を柔らかい色彩と手描きのテクスチャを持つ芸術的な画像に素早く変換することができる。このプロジェクトはAGPLv3ライセンスのもとでライセンスされており、個人および研究目的であれば自由に使用することができます。

機能一覧

• 通常の画像をスタジオジブリ風のアート画像に変換し、アニメ、アート、カスタムスタイルをサポートします。
• FLUX.1-Kontext-devとDFloat11モデルを使用した効率的な画像処理を提供します。
• ローカル操作をサポートし、ユーザーのプライバシーを保護し、画像データはクラウドにアップロードされません。
• テクニカルユーザーに使いやすいコマンドラインインターフェースを提供します。
• Linuxシステムでの実行をサポートし、モバイルおよびデスクトップデバイスと互換性があります。
• 画像処理パラメータをプロファイルで調整し、個々のニーズに合わせることができる。
• オープンソースのプロジェクトで、コードは公開されており、ユーザーは修正や最適化を行うことができる。

ヘルプの使用

設置プロセス

4-o-ghibli-at-homeを使うには、Linuxシステムにインストールする必要がある。以下はその詳細な手順です：

1. プロジェクトコードの複製
   ターミナルを開き、以下のコマンドを入力してプロジェクトをローカルにクローンする：

   git clone https://github.com/TheAhmadOsman/4o-ghibli-at-home.git
   cd 4o-ghibli-at-home
   

2. 仮想環境の構築
   プロジェクトにお勧め uv ツールを使ってPython仮想環境を管理します。もし uvまずはインストールしてください：

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

   インストール後、端末を再起動して uv コマンドが有効になる。次に、仮想環境を作成する：

   uv venv .venv --python 3.12
   source .venv/bin/activate
   

3. 依存関係のインストール
   プロジェクトに必要なPythonの依存関係を仮想環境で同期する：

   uv sync
   

4. 環境変数の設定
   このプロジェクトでは、モデルをダウンロードするためにHugging Faceのアクセストークンが必要です。テンプレートファイルをコピーし、設定します：

   cp .env_template .env
   

   テキストエディタで開く .env ファイルに、Hugging Faceのアクセストークン（Hugging Faceのアカウント設定で生成されたもの）を記入してください。例

   HUGGING_FACE_HUB_TOKEN=your_token_here
   

   通過した場合 huggingface-cli login ログイン時にトークンを手動で設定する必要はありません。

5. サービス開始
   設定が完了したら、プロジェクト・サービスを開始する：

   python3.12 app.py
   

   サービスが開始されると、プロジェクトはローカルのウェブサーバーと画像スタイル変換のためのバックグラウンド処理プロセスを実行する。

使用方法

サービス開始後、ユーザーはコマンドラインまたはウェブインターフェイスから画像をアップロードできます。具体的な操作方法は以下の通りです：

1. 画像の準備
   スタイル変換が必要な画像ファイル（JPGやPNG形式など）があることを確認してください。最良の結果を得るためには、より高精細な画像をお勧めします。
2. 画像のアップロード
   プロジェクトが実行されると、ローカルのウェブ・インターフェイス（通常は http://localhost:5000(特定のポートは起動時のプロンプトに従います）。インターフェイスで画像ファイルを選択し、アップロードをクリックします。
3. スタイルを選ぶ
   インターフェースは、ジブリ風、アニメ風、その他のカスタム風オプションを提供しています。デフォルトの推奨ジブリスタイルは、トトロや千と千尋の神隠しのような手描き風のソフトな効果を模倣しています。
4. 調整パラメーター
   ある .env ファイルまたはウェブインターフェイスで、解像度、彩度、詳細度などの画像処理パラメータを調整できます。初期設定のまま使用することも可能です。
5. 画像の生成
   画像をアップロードし、スタイルを選択したら、「生成」ボタンをクリックします。処理時間はデバイスの性能と画像のサイズに依存し、通常数秒から数分かかります。結果はインターフェイスに表示され、ユーザーは変換された画像をダウンロードすることができます。

注目の機能操作

• ジブリ風スイッチ写真をジブリ風に加工するのが主な機能です。ユーザーが風景や人物の写真をアップロードすると、ツールは自動的にソフトな色彩、繊細なテクスチャ、アニメ風の背景を適用し、スタジオジブリ映画のような画像を作成する。
• プライバシーすべての処理はローカルで行われ、画像はクラウドにアップロードされない。
• カスタムスタイル設定ファイルやコードを変更することで、マンガや水彩画など、他のアートスタイルのサポートを拡張することができます。
• 効率的な処理FLUX.1モデルは、VRAMの使用に最適化されており、世代速度の速いロー～ミッドレンジ・デバイスでの動作に適しています。

ほら

• デバイスに十分なストレージ容量があることを確認してください（モデルファイルはサイズが大きいため、数GB必要な場合があります）。
• 初回実行時にはモデルのダウンロードが必要で、時間がかかる場合がありますので、ネットワークを安定させておくことをお勧めします。
• モデルのダウンロードに失敗した場合は、Hugging Face トークンが正しいかどうかを確認してください。
• このプロジェクトは現在Linuxのみをサポートしており、Windowsユーザーはその後のアップデートを待つ必要がある。

アプリケーションシナリオ

1. 個人的な芸術的創造
   自撮り写真や風景写真など、日常的な写真をジブリ風の作品に変換し、ソーシャルメディアでの共有や個人的なコレクションに活用できる。
2. デザイン素材制作
   イラストレーターやグラフィックデザイナーは、このツールを使ってポスターや壁紙、コンセプトアート用のジブリ風画像を素早く生成することができる。
3. 教育・研究
   AI研究者は、オープンソースのコードを使用して、画像スタイルの変換技術を研究し、FLUX.1モデルを適用できるシナリオを探索することができます。
4. ファン・コミュニティ・プロジェクト
   スタジオジブリファンは、このツールを使ってホモ作品用の画像を生成したり、コミックや壁紙、周辺デザインを作ることができる。

品質保証

1. このツールは無料ですか？
   はい、4-o-ghibli-at-homeはAGPLv3ライセンスのオープンソースプロジェクトであり、個人利用や研究利用は自由です。営利目的で使用する場合は、ライセンス要件を遵守し、改変したソースコードを開示する必要があります。
2. 強力なハードウェアサポートが必要ですか？
   最高級のハードウェアは必要ありませんが、スムーズな体験のためには、少なくとも8GBのRAMと4GBのビデオメモリを搭載したGPUを推奨します。FLUX.1モデルはVRAMの使用に最適化されており、ローレンジからミドルレンジのデバイスに適しています。
3. どのような画像フォーマットに対応していますか？
   JPG、PNGのような一般的なフォーマットをサポートしています。より良い変換結果を得るために、高解像度の画像をお勧めします。
4. モデルのダウンロード失敗を解決するには？
   プローブ .env ファイルで正しいハギング・フェイス・トークンを探すか、あるいは huggingface-cli login ログインしてください。ネットワークが不安定な場合は、ネットワークを変更するか、後でもう一度お試しください。
5. ビデオを変換できますか？
   現在のバージョンは静止画変換のみをサポートしています。動画への対応は将来のアップデートで追加される可能性があります。