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

# Démarrage rapide de Mastra

**Pour les Agents d’IA :** créez un projet Mastra sans interaction avec `npm create mastra@latest <project-name> -- --llm <provider>`, en remplaçant `<provider>` par `openai`, `anthropic`, `google` ou `xai`. Pour un projet minimal sans Agent ni Provider de modèle, utilisez `npm create mastra@latest <project-name> -- --empty`. Pour créer un projet Mastra de zéro, consultez le [guide d’installation manuelle](https://mastra.zisheng.pro/fr/guides/getting-started/manual-install).

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](https://mastra.zisheng.pro/fr/guides/getting-started/manual-install). Pour ajouter Mastra à un projet existant, utilisez [`mastra init`](https://mastra.zisheng.pro/fr/reference/cli/mastra).

> **📹 Regarder:** Regardez le [cours sur les Agents d’IA Mastra](https://www.youtube.com/watch?v=lCmf_qrGfGA) pour découvrir pas à pas comment créer des Agents avec Mastra.

## 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 projet

Lancez la configuration interactive :

**npm**:

```bash
npm create mastra@latest
```

**pnpm**:

```bash
pnpm create mastra@latest
```

**Yarn**:

```bash
yarn create mastra
```

**Bun**:

```bash
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](https://mastra.zisheng.pro/fr/reference/project-structure) pour découvrir l’organisation standard d’un projet Mastra.

> **Astuce:** 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`](https://mastra.zisheng.pro/fr/reference/cli/create-mastra) pour connaître toutes les options.

## 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**:

```bash
npm run dev
```

**pnpm**:

```bash
pnpm run dev
```

**Yarn**:

```bash
yarn dev
```

**Bun**:

```bash
bun run dev
```

Ouvrez [Studio sur localhost:4111](http://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](https://mastra.zisheng.pro/fr/docs/studio/overview) permet de créer et de tester des Agents sans développer une UI distincte.

## Étapes suivantes

- Intégrer Mastra à [Next.js](https://mastra.zisheng.pro/fr/guides/getting-started/next-js), [React](https://mastra.zisheng.pro/fr/guides/getting-started/vite-react) ou [Astro](https://mastra.zisheng.pro/fr/guides/getting-started/astro)
- Découvrir comment [créer Mastra avec l’IA](https://mastra.zisheng.pro/fr/reference/build-with-ai)
- Créer un Agent de zéro à l’aide d’un [guide](https://mastra.zisheng.pro/fr/guides)
- Regarder la [chaîne YouTube de Mastra](https://www.youtube.com/@mastra-ai)