> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qaos.machdel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Installez, mettez à jour et désinstallez le CLI QAOS sur votre machine.

## Avant de commencer

Si vous n'en avez pas encore, [créez un compte QAOS](https://qaos.machdel.com/login) et configurez un projet depuis le [Tableau de bord QAOS](https://qaos.machdel.com). Vous aurez besoin d'un projet pour lancer des audits et consulter les rapports.

***

## Prérequis

Avant d'utiliser QAOS, assurez-vous d'avoir :

* **Node.js 16 ou ultérieur** — [Télécharger depuis nodejs.org](https://nodejs.org)
* **Binaires de navigateur Playwright** — requis pour le navigateur headless qui alimente QAOS
* Un compte QAOS — [Créer un compte](https://qaos.machdel.com/login)

Vérifiez votre version de Node.js :

```bash theme={null}
node --version
# v18.0.0 ou supérieur recommandé
```

npx est inclus avec Node.js — aucune installation séparée n'est nécessaire.

### Installer les binaires de navigateur Playwright

QAOS utilise Playwright en interne pour contrôler un navigateur Chromium. Les binaires du navigateur doivent être installés séparément avant votre première exécution :

```bash theme={null}
npx playwright install chromium
```

<Note>
  Vous n'avez besoin de faire cela qu'une seule fois. Si les binaires sont manquants, QAOS affichera un message d'erreur clair vous rappelant d'exécuter cette commande.
</Note>

***

## Exécuter sans installer

Vous pouvez exécuter QAOS directement avec npx sans rien installer globalement :

```bash theme={null}
npx qaos --version
```

npx téléchargera la dernière version du CLI à la première utilisation et la mettra en cache localement.

***

## Installation globale (optionnel)

Si vous préférez avoir `qaos` disponible en tant que commande autonome, vous pouvez l'installer globalement :

```bash theme={null}
npm install --global qaos
```

Vous pourrez ensuite exécuter `qaos` directement au lieu de `npx qaos`.

***

## Mise à jour

Pour exécuter la dernière version avec npx, utilisez le tag `@latest` :

```bash theme={null}
npx qaos@latest --version
```

Si vous avez installé globalement, mettez à jour avec :

```bash theme={null}
npm install --global qaos@latest
```

***

## Désinstallation

Si vous avez installé QAOS globalement et souhaitez le supprimer :

```bash theme={null}
npm uninstall --global qaos
```

Si vous avez seulement utilisé npx, il n'y a rien à désinstaller — les caches npx sont gérés automatiquement par npm.

***

## Résolution de problèmes

<AccordionGroup>
  <Accordion title="'qaos' n'est pas reconnu comme une commande">
    Si vous utilisez npx, assurez-vous d'exécuter `npx qaos` et non simplement `qaos`. Si vous avez installé globalement et que la commande n'est pas trouvée, le répertoire bin global de npm n'est peut-être pas dans votre `PATH`. Exécutez :

    ```bash theme={null}
    npm bin -g
    ```

    Ajoutez le chemin affiché à la variable `PATH` de votre shell (`.bashrc`, `.zshrc` ou équivalent).
  </Accordion>

  <Accordion title="Version de Node.js trop ancienne">
    QAOS nécessite Node.js 16 ou ultérieur. Mettez à jour avec [nvm](https://github.com/nvm-sh/nvm) :

    ```bash theme={null}
    nvm install --lts
    nvm use --lts
    ```
  </Accordion>
</AccordionGroup>

***

## Étapes suivantes

Une fois prêt, [authentifiez votre CLI](/fr/getting-started/authentication) pour le connecter à votre compte QAOS.