create-mastra
スタンドアロンの Mastra プロジェクトを作成します。デフォルトでは、create-mastra はデフォルトのスターターをインストールし、選択したモデル Provider 用に設定します。
- npm
- pnpm
- Yarn
- Bun
npx create-mastra@latest
pnpm dlx create-mastra@latest
yarn dlx create-mastra@latest
bun x create-mastra@latest
作成モード作成モードへの直接リンク
デフォルトのスターターデフォルトのスターターへの直接リンク
デフォルトのスターターは、Workspace Tool、Memory、タスク追跡、Web アクセス、定期スケジュール、ストレージ、Observability を備えた Agent ハーネスを作成します。モデル Provider として OpenAI、Anthropic、Gemini、または xAI を選択します。
プロンプトなしでプロジェクトを作成するには、プロジェクト名と Provider の両方を指定します。次の例では Anthropic を使用していますが、openai、google、xai も指定できます。
- npm
- pnpm
- Yarn
- Bun
npx create-mastra@latest my-mastra-project --llm anthropic
pnpm dlx create-mastra@latest my-mastra-project --llm anthropic
yarn dlx create-mastra@latest my-mastra-project --llm anthropic
bun x create-mastra@latest my-mastra-project --llm anthropic
--llm を省略すると、Provider を対話形式で選択し、必要に応じて API キーを入力できます。対話形式のセットアップでは、プロジェクトを Mastra platform に接続することもできます。有効にすると、コマンドはブラウザーの認証フローを開き、ローカルプロジェクトと同じ名前の platform プロジェクトを作成します。その後、MASTRA_PLATFORM_ACCESS_TOKEN と MASTRA_PROJECT_ID を .env に書き込みます。
テンプレートテンプレートへの直接リンク
テンプレートの slug または公開 GitHub URL を使用します。
- npm
- pnpm
- Yarn
- Bun
npx create-mastra@latest my-mastra-project --template agent-harness
pnpm dlx create-mastra@latest my-mastra-project --template agent-harness
yarn dlx create-mastra@latest my-mastra-project --template agent-harness
bun x create-mastra@latest my-mastra-project --template agent-harness
- npm
- pnpm
- Yarn
- Bun
npx create-mastra@latest my-mastra-project --template https://github.com/mastra-ai/template-agent-harness
pnpm dlx create-mastra@latest my-mastra-project --template https://github.com/mastra-ai/template-agent-harness
yarn dlx create-mastra@latest my-mastra-project --template https://github.com/mastra-ai/template-agent-harness
bun x create-mastra@latest my-mastra-project --template https://github.com/mastra-ai/template-agent-harness
テンプレートを対話形式で選択するには、テンプレートの値を空のままにします。
- npm
- pnpm
- Yarn
- Bun
npx create-mastra@latest my-mastra-project --template
pnpm dlx create-mastra@latest my-mastra-project --template
yarn dlx create-mastra@latest my-mastra-project --template
bun x create-mastra@latest my-mastra-project --template
テンプレートの依存関係、モデル、環境変数、ソースコードは、テンプレートの作成者が管理します。create-mastra は --llm または --llm-api-key を適用しません。
空のスキャフォールド空のスキャフォールドへの直接リンク
Agent、サンプル、モデル SDK、環境ファイルを含まない、Provider に依存しないプロジェクトを作成するには、--empty を使用します。
- npm
- pnpm
- Yarn
- Bun
npx create-mastra@latest my-empty-project --empty
pnpm dlx create-mastra@latest my-empty-project --empty
yarn dlx create-mastra@latest my-empty-project --empty
bun x create-mastra@latest my-empty-project --empty
自動セットアップ自動セットアップへの直接リンク
依存関係をインストールした後、コマンドは次の処理を行います。
PATH上でサポートされているコーディングアシスタントを検出し、Mastra Skill をインストールします。何も検出されない場合は、汎用 Skill をインストールします。- 現在のディレクトリと生成されたプロジェクトがどちらも既存の Git リポジトリ内にない場合、最初の Git コミットを作成します。
これらの手順を省略するには、--no-skills または --no-git を使用します。Skill や Git のセットアップに失敗すると警告が表示されますが、正常に作成されたプロジェクトは削除されません。
競合と検証競合と検証への直接リンク
--emptyと--templateは同時に使用できません。--llmと--llm-api-keyは、デフォルトのスタータープロジェクトでのみ有効です。- プロジェクト名は、安全な小文字の単一ディレクトリ名にする必要があり、対象がすでに存在していてはなりません。
無効な入力は、テンプレートの取得やファイルの作成前に拒否されます。
引数とフラグ引数とフラグへの直接リンク
[project-name]?:
--empty?:
-l, --llm <provider>?:
-k, --llm-api-key <key>?:
--no-skills?:
--no-git?:
--no-install?:
-t, --template [template]?:
--timeout <milliseconds>?:
--version?:
--help?:
テレメトリテレメトリへの直接リンク
Mastra は、オペレーティングシステム、Mastra のバージョン、Node.js のバージョンなど、匿名の CLI 使用情報を収集します。分析機能のソースを確認できます。
オプトアウトするには、MASTRA_TELEMETRY_DISABLED=1 を設定します。
MASTRA_TELEMETRY_DISABLED=1 npx create-mastra@latest my-project --empty