ワークスペースセットアップ
macOS(Apple Silicon)、Linux(apt を使用、Ubuntu 22.04+、Debian 12+)、Windows(WSL 2)で動作します。このリポジトリには、ルール、スキル、ツール、共有 CC0 サウンド、Previs Studio、および1つのデモフィルムが含まれていますが、機械や個人に紐づくもの(API キー、.venv、node_modules、ユーザーレベルのスキルやプラグイン、OWNER.md)は含まれていません。このスキルは、オーナーがすぐにスタジオを使えるようにします。SETUP.md は人が読むための同じ手順書です。
オーナーにはわかりやすい言葉で話しかけてください。オーナーは技術に詳しくない可能性があり、モーションデザインについて何も知らないかもしれません。一度に1ステップずつ、何をするのか、なぜ必要なのか、どのくらいの時間がかかるのかを説明してください。
厳格なルール
- API キーをチャットで尋ねたり、入力、エコー、ログ、書き込みを絶対にしないでください。 キーは
scripts/setup/keys.shを通じて入力します。このスクリプトはオーナーが自分のターミナルで非表示入力(macOS のキーチェーン、Linux/WSL 2 では secret store または~/.config/motion-studio/keys.env)を使用して実行します。もしオーナーが誤ってチャットにキーを貼り付けた場合:そのキーを使用したり保存したりしないでください。キーがチャット履歴に残っていることを伝え、プロバイダーのサイトでそのキーを削除して新しいキーを作成し、keys.shで保存するように指示してください。 - インストールはオーナーの承認が必要です(AGENTS.md の「Ask first」ルール)。
install.shの各ステップを実行する前にAskUserQuestionで承認を求め、ダウンロードサイズを明示してください。 - 自分で
sudoを実行しないでください。 macOS では Homebrew のインストーラーがパスワードを必要とします。Linux/WSL 2 ではbash scripts/setup/install.sh system(apt を使用)がパスワードを必要とします。これらのコマンドはオーナーが自分のターミナルで実行します。(Claude Code のクラウドセッションでは root 権限があるため、自分で実行できます。)
手順
- まだリポジトリをクローンしていない場合: 現在のフォルダーが motion-studio のコピーでない(
AGENTS.mdに "motion-studio" が含まれておらず、scripts/setup/ディレクトリがない)場合、まずクローンします:git clone https://github.com/jayfirke/motion-studio.git motion-studio(保存場所を尋ね、デフォルトはホームまたはカレントフォルダーのmotion-studioフォルダー)。その後、そのフォルダー内で作業します。最後に、そのフォルダー内で新しいセッションを開くように伝えます。 - 挨拶と期待値の設定を3行で行います:セットアップの内容(ツールの確認、不足品のインストール、設定の書き込み、キーの保存)、所要時間15〜30分、ダウンロード容量約3 GB(システムパッケージ、Chromium、1.6 GB の Whisper モデル)。また、システムが検出した OS(macOS、Linux、または WSL 2)を伝えます。
- チェック:
bash scripts/setup/doctor.shを実行します。NEED 行(それぞれの用途)をわかりやすく説明し、OPT 行を1文でまとめます。 - システムツール。
- macOS で Homebrew がない場合: 公式インストーラー(https://brew.sh)をターミナルで自分で実行するように依頼します(パスワードが必要です)。インストーラーが表示する「Next steps」の指示に従うように伝えます。
- Linux / WSL 2 の場合:
bash scripts/setup/install.sh systemを自分のターミナルで実行するように依頼します(apt はパスワードが必要です。このスクリプトはwhisper-cliのビルド、Node 22 と uv のインストールも行います)。ARM Linux の場合、export HYPERFRAMES_BROWSER_PATH=…という行が出力されるので、シェルのプロファイルに追加するように伝えます。 「完了」の応答を待ってから、再度 doctor を実行します。
- インストールの選択 を1つの
AskUserQuestion(multiSelect)で行います。doctor が不足とマークしたものだけを提示します:- 「Core studio」= macOS では
install.sh core(Homebrew ツール、Python venv、Claude スキル、Claude プラグイン)。Linux/WSL 2 では、systemステップの後にinstall.sh venv skills pluginsを実行。推奨。 - 「Whisper model, 1.6 GB」=
install.sh whisper-model(キャプションと音声チェック用のワードタイミング)。推奨。 - 「Previs Studio packages」=
install.sh app(Previs Studio を再構築し、チェックを実行)。 - 「onetake」=
install.sh onetake:個人用、非商用実験のみ(PolyForm Noncommercial ライセンス)。 - 「Motion Reel Kit」=
install.sh motion-reel <kit folder>:キットをクリエイターから購入またはダウンロードした場合のみ(CREDITS.md参照)。このリポジトリには含まれていません。 承認されたステップをワークスペースルートから実行します。時間のかかるステップ(brew、whisper-model)はバックグラウンドで実行し、何が動いているかを伝えます。ステップがFAIL …と表示した場合、修正方法を試し、一度試してもダメなら説明してから再度尋ねます。
- 「Core studio」= macOS では
- 設定の入力。
OWNER.example.mdをOWNER.mdにコピーし、1回または2回のAskUserQuestionで質問をします(名前、制作内容、個人/商用利用、モーションデザインの経験、デフォルトの音声、品質基準、予算と承認プロセス)。回答をOWNER.mdにオーナーの言葉で書き込みます。このファイルは git 管理外で、共有されることはありません。 - API キー。
AskUserQuestionで今どのキーを設定したいか尋ねます:- Fish Audio(すべてのナレーションに必要。無料アカウントあり。無料モデル
s2.1-pro-freeは2026年11月30日まで無料):キーは https://fish.audio/app/api-keys/ で取得。 - Freesound(オプション。新しい効果音を検索・ダウンロードする場合のみ。無料アカウント):https://freesound.org/apiv2/apply/ で申請し、「Client secret/Api key」と「Client id」をコピー。
その後、オーナーに自分のターミナルで
bash scripts/setup/keys.shを実行してもらいます: - Claude デスクトップアプリで
run_in_terminalツールが利用可能な場合、cd "<workspace>" && bash scripts/setup/keys.shをターミナルパネルで起動し、そこで入力するように伝えます。入力中はパネルを見ないでください。 - それ以外の場合は、ターミナル(macOS のターミナル、Linux または WSL のターミナル)を開き、
cd <workspace> && bash scripts/setup/keys.shを貼り付けるように依頼します。 完了したと言われたら、bash scripts/setup/doctor.sh --onlineを実行します。キーが表示されずに動作確認が行われます。
- Fish Audio(すべてのナレーションに必要。無料アカウントあり。無料モデル
- オプションの追加機能(短いリストから選択):
- Diffusion Studio(実写映像のカット、オブジェクトマスク):macOS ではアプリを https://diffusion.studio からダウンロードし、一度開いた後、
install.sh diffusion-mcpを実行します。Linux では Web アプリ(https://app.diffusion.studio)として動作し、MCP は不要です。 - claude.ai の Fish Audio コネクター(Settings → Connectors)。必須ではありません。スクリプトがキーを直接使用します。
- Remotion は個人および3人以下の企業は無料。3人を超える企業は Remotion ライセンスが必要です。
- Diffusion Studio(実写映像のカット、オブジェクトマスク):macOS ではアプリを https://diffusion.studio からダウンロードし、一度開いた後、
- 完了。
.local/setup.jsonを作成します(.local/ディレクトリを作成。git 管理外):{"owner": "<ファーストネーム>", "setup_at": "<UTC 時刻 (date -u +%Y-%m-%dT%H:%M:%SZ)>", "by": "workspace-setup", "doctor": "<DOCTOR 行>"}bash scripts/setup/session-check.shを実行し(何も出力されないはず)、再度 doctor を実行します。準備ができたものとスキップされたものを報告します。 - 次にすべきことを伝えます:
- このフォルダーで 新しい Claude Code セッションを開始してください。スキル、プラグイン、Diffusion MCP はセッション開始時にのみ読み込まれます。
- デモを開く:
python3 -m http.server 8790 --directory _shared/previs/studioを実行し、http://localhost:8790 にアクセス(Previs Studio と Crumb デモフィルム)。 - 最初のプロンプト例:「<あなたの製品> の15秒ローンチリールを作成してください。まず Previs で。」
再実行
いつでも bash scripts/setup/doctor.sh を実行できます。bash scripts/setup/install.sh <step> で1つのステップを安全に再実行できます。.local/setup.json を削除すると、セットアップ全体を再度実行できます。