ZenCtrlローカルセットアップガイド

はじめに：前提条件と注意点

この手順は、コマンドライン（ターミナルやPowerShellなど）の基本的な操作に慣れている方を対象としています。

• ⚠️ 最も重要な注意点（ハードウェア）： ZenCtrlのモデルは非常に大きく、動作させるには24GB以上のVRAM（ビデオメモリ）を持つ高性能なNVIDIA製GPUが強く推奨されています。一般的なノートPCやゲーミングPCではスペックが不足し、動作しないか非常に遅くなる可能性が高いです。
• 必要なソフトウェア：
  1. Git: ソースコードをダウンロードするために必要です。git-scm.comからインストールしてください。
  2. Anaconda (または Miniconda): Pythonの環境を管理するために使います。Python本体と多くの科学技術計算ライブラリをまとめてインストールできるAnacondaがおすすめです。Anaconda Distributionからインストールしてください。

---

⚙️ Step 1: プロジェクトの準備

まず、ZenCtrlのソースコードをGitHubからご自身のPCにダウンロードします。

1. ターミナルを開く:

   • Windowsなら「PowerShell」や「Anaconda Prompt」
   • Macなら「ターミナル」

2. プロジェクトを置きたいフォルダに移動します。

3. **以下のコマンドを実行して、ソースコードをダウンロード（クローン）します。**Bash

   git clone https://github.com/FotographerAI/ZenCtrl.git

4. **ダウンロードしたプロジェクトフォルダに移動します。**Bash

   cd ZenCtrl

---

🐍 Step 2: Python仮想環境の構築

次に、ZenCtrl専用の独立したPython環境を作ります。これにより、PC内の他のPythonプロジェクトとの間でライブラリのバージョンが競合するのを防ぎます。

1. Anacondaを使ってzenctrlという名前の仮想環境を作成します。 (Pythonのバージョンは3.10が安定しているため推奨します)Bash

   conda create -n zenctrl python=3.10

   実行中に Proceed ([y]/n)? と聞かれたら、y を入力してEnterキーを押してください。

2. **作成した仮想環境を有効化（アクティベート）します。**Bash

   conda activate zenctrl

   ターミナルの行頭に (zenctrl) と表示されれば、仮想環境に入った状態です。

---

📦 Step 3: 必要なライブラリのインストール

ZenCtrlを動かすために必要なPythonライブラリを一括でインストールします。

1. **プロジェクトフォルダ内にあるrequirements.txtファイルを使って、ライブラリをインストールします。**Bash

   pip install -r requirements.txt

   これには数分かかる場合があります。

2. 【重要】PyTorchのインストール:requirements.txtでのインストールがうまくいかない場合（特にGPU関連のエラーが出る場合）、PyTorch公式サイトからご自身の環境（OS、CUDAのバージョン）に合ったコマンドを取得して、手動でインストールする必要があります。

   • PyTorch公式サイト にアクセスし、ご自身の環境を選択して表示されるコマンドを実行してください。

---

🧠 Step 4: モデルのダウンロード

ソースコードとは別に、学習済みのAIモデル本体（非常に大きなファイル）をダウンロードする必要があります。

1. Hugging FaceのFotographer AIページにアクセスします。
   • huggingface.co/fotographerai
2. ZenCtrl関連のリポジトリを探します。
3. 「Files and versions」タブを開き、モデルファイル（.safetensorsや.pth形式のファイル）をダウンロードします。
4. ダウンロードしたモデルファイルを、プロジェクト内の指定されたフォルダに配置します。
   • 多くの場合、modelsやcheckpointsといった名前のフォルダに入れます。正確な場所は、プロジェクトのREADME.mdファイルに記載されているはずですので、必ず確認してください。

---

🚀 Step 5: アプリケーションの実行

すべての準備が整ったら、いよいよZenCtrlを起動します。

1. ターミナルで以下のコマンドを実行します。 (起動スクリプトはapp.pyであることが多いです)Bash

   python app.py

   • もしapp.pyで起動しない場合は、README.mdファイルで正しい起動コマンドを確認してください。

2. 起動に成功すると、ターミナルに以下のようなURLが表示されます。

   Running on local URL: http://127.0.0.1:7860

3. このURLをコピーして、お使いのWebブラウザ（ChromeやEdgeなど）のアドレスバーに貼り付けてアクセスします。 ZenCtrlの操作画面が表示されれば、セットアップは成功です！

トラブルシューティングと補足

• 公式ドキュメントが最優先: このガイドは一般的な手順です。最新かつ最も正確な情報は、必ずGitHubにある公式のREADME.mdファイルで確認してください。
• エラーが出た場合: インストール中にエラーが出た場合は、エラーメッセージをよく読み、PyTorchのバージョンやGPUドライバ（CUDA）が適切かを確認することが解決の近道です。
• コミュニティの活用: GitHubリポジトリの「Issues」セクションでは、他のユーザーが遭遇した問題やその解決策が議論されている場合があります。困ったときには非常に参考になります。

---

Author: 村井 | Source: 村井\多角視点画像生成AI ZenCtrl調査\ZenCtrlローカルセットアップガイド 233aba435ee7802bb24de3be92bbd4b4.md