> Discover all available pages from the documentation index: https://mastra.zisheng.pro/fr/llms.txt # create-mastra Créez un projet Mastra autonome. Par défaut, `create-mastra` installe un starter par défaut et le configure pour le fournisseur de modèles sélectionné. **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 ``` ## Modes de création ### Starter par défaut Le starter par défaut crée un environnement d’agent avec des outils d’espace de travail, de la mémoire, le suivi des tâches, un accès web, des planifications récurrentes, du stockage et de l’observabilité. Sélectionnez OpenAI, Anthropic, Gemini ou xAI comme fournisseur de modèles. Indiquez le nom du projet et le fournisseur pour créer le projet sans invites. Cet exemple utilise Anthropic ; vous pouvez également passer `openai`, `google` ou `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 ``` Omettez `--llm` pour sélectionner le fournisseur et, si vous le souhaitez, saisir sa clé API de manière interactive. La configuration interactive propose également de connecter votre projet à la plateforme Mastra. Si vous l’activez, la commande ouvre le flux d’authentification dans le navigateur et crée un projet sur la plateforme portant le même nom que le projet local. Elle écrit ensuite `MASTRA_PLATFORM_ACCESS_TOKEN` et `MASTRA_PROJECT_ID` dans `.env`. ### Modèle Utilisez un slug de modèle ou une URL GitHub publique : **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 ``` Laissez la valeur du modèle vide pour sélectionner un modèle de manière interactive : **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 ``` Les auteurs de modèles sont responsables de leurs dépendances, modèles, variables d’environnement et code source. `create-mastra` n’applique pas `--llm` ni `--llm-api-key`. ### Squelette vide Utilisez `--empty` pour créer un projet sans fournisseur, agents, exemples, SDK de modèles ni fichiers d’environnement : **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 ``` ## Configuration automatique Après l’installation des dépendances, la commande : 1. Détecte les assistants de programmation pris en charge dans `PATH` et installe les skills Mastra. Si aucun n’est détecté, elle installe les skills universels. 2. Crée un commit Git initial lorsque le répertoire actuel et le projet généré ne se trouvent pas déjà dans des dépôts Git. Utilisez `--no-skills` ou `--no-git` pour ignorer ces étapes. Les échecs de configuration des skills et de Git produisent des avertissements, mais ne suppriment pas un projet créé avec succès. ## Conflits et validation - `--empty` et `--template` ne peuvent pas être utilisés ensemble. - `--llm` et `--llm-api-key` sont valides uniquement pour le projet utilisant le starter par défaut. - Le nom du projet doit être un nom de répertoire unique, sûr et en minuscules, et la cible ne doit pas déjà exister. Les entrées non valides sont rejetées avant que les modèles soient récupérés ou que des fichiers soient créés. ## Arguments et options **\[project-name]** (`string`): Répertoire du projet et nom du package. S’il est omis, la commande le demande. **--empty** (`boolean`): Crée un projet Mastra minimal sans fournisseur. **-l, --llm \** (`string`): Fournisseur géré pour l’environnement d’agent : openai, anthropic, google ou xai. **-k, --llm-api-key \** (`string`): Écrit la clé API du fournisseur sélectionné dans le fichier .env généré lorsque la configuration automatique du fournisseur réussit. **--no-skills** (`boolean`): Ignore l’installation automatique des skills Mastra. **--no-git** (`boolean`): Ignore l’initialisation automatique de Git et le commit initial. **--no-install** (`boolean`): Ignore l’installation des dépendances. **-t, --template \[template]** (`string`): Utilise un slug de modèle ou une URL GitHub publique. Omettez la valeur pour sélectionner de manière interactive. **--timeout \** (`number`): Délai d’expiration entier positif pour l’installation des dépendances. La valeur par défaut est 60000. **--version** (`boolean`): Affiche la version de create-mastra. **--help** (`boolean`): Affiche l’aide de la commande. ## Télémétrie Mastra collecte des informations anonymes sur l’utilisation de la CLI, telles que le système d’exploitation, la version de Mastra et la version de Node.js. Vous pouvez consulter le [code source des analyses](https://github.com/mastra-ai/mastra/blob/main/packages/cli/src/analytics/index.ts). Définissez `MASTRA_TELEMETRY_DISABLED=1` pour désactiver cette collecte : ```bash MASTRA_TELEMETRY_DISABLED=1 npx create-mastra@latest my-project --empty ```