> Discover all available pages from the documentation index: https://mastra.zisheng.pro/ja/llms.txt

# create-mastra

スタンドアロンの Mastra プロジェクトを作成します。デフォルトでは、`create-mastra` はデフォルトのスターターをインストールし、選択したモデル Provider 用に設定します。

**npm**:

```bash
npx create-mastra@latest
```

**pnpm**:

```bash
pnpm dlx create-mastra@latest
```

**Yarn**:

```bash
yarn dlx create-mastra@latest
```

**Bun**:

```bash
bun x create-mastra@latest
```

## 作成モード

### デフォルトのスターター

デフォルトのスターターは、Workspace Tool、Memory、タスク追跡、Web アクセス、定期スケジュール、ストレージ、Observability を備えた Agent ハーネスを作成します。モデル Provider として OpenAI、Anthropic、Gemini、または xAI を選択します。

プロンプトなしでプロジェクトを作成するには、プロジェクト名と Provider の両方を指定します。次の例では Anthropic を使用していますが、`openai`、`google`、`xai` も指定できます。

**npm**:

```bash
npx create-mastra@latest my-mastra-project --llm anthropic
```

**pnpm**:

```bash
pnpm dlx create-mastra@latest my-mastra-project --llm anthropic
```

**Yarn**:

```bash
yarn dlx create-mastra@latest my-mastra-project --llm anthropic
```

**Bun**:

```bash
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**:

```bash
npx create-mastra@latest my-mastra-project --template agent-harness
```

**pnpm**:

```bash
pnpm dlx create-mastra@latest my-mastra-project --template agent-harness
```

**Yarn**:

```bash
yarn dlx create-mastra@latest my-mastra-project --template agent-harness
```

**Bun**:

```bash
bun x create-mastra@latest my-mastra-project --template agent-harness
```

**npm**:

```bash
npx create-mastra@latest my-mastra-project --template https://github.com/mastra-ai/template-agent-harness
```

**pnpm**:

```bash
pnpm dlx create-mastra@latest my-mastra-project --template https://github.com/mastra-ai/template-agent-harness
```

**Yarn**:

```bash
yarn dlx create-mastra@latest my-mastra-project --template https://github.com/mastra-ai/template-agent-harness
```

**Bun**:

```bash
bun x create-mastra@latest my-mastra-project --template https://github.com/mastra-ai/template-agent-harness
```

テンプレートを対話形式で選択するには、テンプレートの値を空のままにします。

**npm**:

```bash
npx create-mastra@latest my-mastra-project --template
```

**pnpm**:

```bash
pnpm dlx create-mastra@latest my-mastra-project --template
```

**Yarn**:

```bash
yarn dlx create-mastra@latest my-mastra-project --template
```

**Bun**:

```bash
bun x create-mastra@latest my-mastra-project --template
```

テンプレートの依存関係、モデル、環境変数、ソースコードは、テンプレートの作成者が管理します。`create-mastra` は `--llm` または `--llm-api-key` を適用しません。

### 空のスキャフォールド

Agent、サンプル、モデル SDK、環境ファイルを含まない、Provider に依存しないプロジェクトを作成するには、`--empty` を使用します。

**npm**:

```bash
npx create-mastra@latest my-empty-project --empty
```

**pnpm**:

```bash
pnpm dlx create-mastra@latest my-empty-project --empty
```

**Yarn**:

```bash
yarn dlx create-mastra@latest my-empty-project --empty
```

**Bun**:

```bash
bun x create-mastra@latest my-empty-project --empty
```

## 自動セットアップ

依存関係をインストールした後、コマンドは次の処理を行います。

1. `PATH` 上でサポートされているコーディングアシスタントを検出し、Mastra Skill をインストールします。何も検出されない場合は、汎用 Skill をインストールします。
2. 現在のディレクトリと生成されたプロジェクトがどちらも既存の Git リポジトリ内にない場合、最初の Git コミットを作成します。

これらの手順を省略するには、`--no-skills` または `--no-git` を使用します。Skill や Git のセットアップに失敗すると警告が表示されますが、正常に作成されたプロジェクトは削除されません。

## 競合と検証

- `--empty` と `--template` は同時に使用できません。
- `--llm` と `--llm-api-key` は、デフォルトのスタータープロジェクトでのみ有効です。
- プロジェクト名は、安全な小文字の単一ディレクトリ名にする必要があり、対象がすでに存在していてはなりません。

無効な入力は、テンプレートの取得やファイルの作成前に拒否されます。

## 引数とフラグ

**\[project-name]** (`string`): プロジェクトのディレクトリ名とパッケージ名。省略した場合、コマンドから入力を求められます。

**--empty** (`boolean`): 最小構成で Provider に依存しない Mastra プロジェクトを作成します。

**-l, --llm \<provider>** (`string`): 管理対象の Agent ハーネス Provider：openai、anthropic、google、xai。

**-k, --llm-api-key \<key>** (`string`): Provider の自動セットアップに成功した場合、選択した Provider の API キーを生成された .env ファイルに書き込みます。

**--no-skills** (`boolean`): Mastra Skill の自動インストールを省略します。

**--no-git** (`boolean`): Git の自動初期化と最初のコミットを省略します。

**--no-install** (`boolean`): 依存関係のインストールを省略します。

**-t, --template \[template]** (`string`): テンプレートの slug または公開 GitHub URL を使用します。対話形式で選択するには値を省略します。

**--timeout \<milliseconds>** (`number`): 依存関係のインストールに使用する正の整数のタイムアウト。デフォルトは 60000 です。

**--version** (`boolean`): create-mastra のバージョンを出力します。

**--help** (`boolean`): コマンドのヘルプを表示します。

## テレメトリ

Mastra は、オペレーティングシステム、Mastra のバージョン、Node.js のバージョンなど、匿名の CLI 使用情報を収集します。[分析機能のソース](https://github.com/mastra-ai/mastra/blob/main/packages/cli/src/analytics/index.ts)を確認できます。

オプトアウトするには、`MASTRA_TELEMETRY_DISABLED=1` を設定します。

```bash
MASTRA_TELEMETRY_DISABLED=1 npx create-mastra@latest my-project --empty
```