Arta Edit Studio — セットアップ
新しくクローンしたリポジトリを /reel-story と /reel-split に備えて準備し、カスタマイズします。
各ステップを実行する前に、平易な一文で説明してください。多くのユーザーは開発者ではありません。
ダウンロードやインストールを行う前に必ずユーザーに確認し（パッケージ、フォント、モデルの重みファイル）、おおよそのサイズを伝えてください。
引数: $ARGUMENTS
1. マシンを確認 — ✅ / ❌ 表で報告
| 必要なもの | 確認方法 | 欠けている場合の対処法 |
|---|---|---|
| Python ≥ 3.10 | python --version | python.org |
| Node ≥ 18 | node --version | nodejs.org (LTS) |
| ffmpeg with zscale | ffmpeg -hide_banner -filters に zscale が含まれていること | Windows: gyan.dev "full" ビルド · macOS: brew install ffmpeg |
| NVIDIA GPU (オプション) | nvidia-smi | なし → Whisper は CPU で動作、約10倍遅い |
| レンダリング用 Chrome | npx hyperframes doctor（ステップ2の後） | doctor が対処法を表示 |
2. インストール（事前に確認）
python -m venv .venv- PyTorch — この OS 向けの pytorch.org のコマンド。NVIDIA GPU がある場合は CUDA ビルド（約 2.5 GB）、それ以外は CPU 版。
.venv/Scripts/python -m pip install -r requirements.txt（macOS/Linux:.venv/bin/python）。npm install（HyperFrames レンダラー、GSAP、Lucide アイコン）。npx hyperframes doctor— 指摘された問題を修正。- ユーザーに伝える: Whisper の
large-v3モデル（約 3 GB）は最初の文字起こし時にダウンロードされます。
3. フォント
設定の fonts を読み込みます。font/ から見つからないファイルごとに、無料デフォルトの入手先をユーザーに伝え、ダウンロードを提案します（事前に確認）:
- ペルシャ語
Vazirmatn-Medium.ttf— github.com/rastikerdar/vazirmatn（リリース）、OFL - ラテン文字
Poppins-SemiBold.ttfと表示用Poppins-Black.ttf— fonts.google.com/specimen/Poppins、OFL
他のフォントも使用可能です: ファイルを font/ に置き、設定のパスを変更してください。
4. 個人設定
reel.config.json が存在しない場合、reel.config.example.json をコピーして作成します。その後、1回のメッセージで以下を質問します（引数ですでに回答済みのものはスキップ）:
- 名前と Instagram ハンドル（フォローカード用）
- 動画の話し言葉（
fa、en、ar、de、…） - ブランド / 製品名（任意）とその色 — または色を抽出するためのロゴファイル
- マスコット / キャラクター画像（任意） →
assets/mascot/に配置。ロゴ →assets/brand/logo.png - Bロールクリップの場所（デフォルト
assets/broll/）
回答を reel.config.json に書き込みます（サンプルにあるすべてのキーを保持）。
5. スモークテスト
.venv/Scripts/python -X utf8 -c "import sys; sys.path.insert(0,'tools'); import config, story_build, showcase_build; print('tools ok')"raw/に動画がすでにある場合:$PY tools/face_track.py <take>で顔の位置が表示されるはずです。
6. 引き継ぎ
ユーザーの言語で、それぞれ1つの例を示した簡単な「使い方」を表示します:
/reel-story <take> <トピック、コメントキーワード、名前> と /reel-split <take> …。