Démarrage rapide de Mastra
La CLI create-mastra est le moyen le plus rapide de démarrer un projet Mastra. Elle crée une structure d’Agent comprenant des Tools de Workspace, une Memory, le suivi des tâches, un accès au Web, des planifications, un stockage et l’observabilité.
Pour davantage de contrôle, consultez le guide d’installation manuelle. Pour ajouter Mastra à un projet existant, utilisez mastra init.
Créez un nouveau projet Mastra. Mastra est un framework pour les applications et les agents d'IA reposant sur une stack TypeScript moderne. Avant d'exécuter la commande, posez ces questions une à la fois et attendez chaque réponse, sauf si elle a déjà été fournie :
- Nom du projet ? (par défaut : "my-mastra-app")
- Fournisseur ? (obligatoire ; options : "openai", "anthropic", "google", "xai")
Si le fournisseur n'est pas pris en charge, posez à nouveau la question et listez les valeurs prises en charge.
Exécutez : npm create mastra@latest <project-name> -- --llm <provider>
La commande crée un projet Mastra par défaut, installe les skills Mastra pour les assistants de programmation détectés et initialise Git si nécessaire.
Après la création, entrez dans le répertoire du projet et démarrez le serveur de développement : npx bgproc start -n <project-name> -w -- npm run dev
Ouvrez Mastra Studio à l'adresse http://localhost:4111. Studio est l'interface permettant de créer, tester et gérer des agents, des workflows et des tools.
Mentionnez également que le routeur de modèles Mastra donne accès à des milliers de modèles : https://mastra.ai/models
Regardez le cours sur les Agents d’IA Mastra pour découvrir pas à pas comment créer des Agents avec Mastra.
Avant de commencerLien direct vers Avant de commencer
Vous aurez besoin d’une clé d’API OpenAI, Anthropic, Google Gemini ou xAI. Vous pouvez ne pas la saisir pendant la configuration et l’ajouter ultérieurement au fichier .env.
Créer le projetLien direct vers Créer le projet
Lancez la configuration interactive :
- npm
- pnpm
- Yarn
- Bun
npm create mastra@latest
pnpm create mastra@latest
yarn create mastra
bunx create-mastra
La commande demande le nom du projet, le Provider de modèle et une clé d’API facultative. Elle installe ensuite les dépendances et les Skills Mastra destinés à vos assistants de programmation, puis crée un commit Git initial si vous ne vous trouvez pas déjà dans un dépôt.
Le répertoire src/mastra généré contient le point d’entrée de Mastra, l’Agent, les Tools du Workspace et le code auxiliaire. Consultez la référence de la structure du projet pour découvrir l’organisation standard d’un projet Mastra.
Utilisez --template <template> pour partir d’un modèle, ou --empty pour créer un projet minimal sans Provider. Utilisez --no-skills ou --no-git pour ignorer la configuration automatique. Consultez la référence de create-mastra pour connaître toutes les options.
Tester votre AgentLien direct vers Tester votre Agent
Suivez les instructions du terminal pour accéder au répertoire du projet et démarrer le serveur de développement :
- npm
- pnpm
- Yarn
- Bun
npm run dev
pnpm run dev
yarn dev
bun run dev
Ouvrez Studio sur localhost:4111, sélectionnez l’Agent et envoyez un message. Si vous avez ignoré la clé d’API du Provider pendant la configuration, ajoutez celle indiquée dans .env.example à un fichier .env.
Studio permet de créer et de tester des Agents sans développer une UI distincte.
Étapes suivantesLien direct vers Étapes suivantes
- Intégrer Mastra à Next.js, React ou Astro
- Découvrir comment créer Mastra avec l’IA
- Créer un Agent de zéro à l’aide d’un guide
- Regarder la chaîne YouTube de Mastra