---
title: Installation
summary: Téléchargez HeartBeatAgents pour macOS, Windows ou Linux et faites-le fonctionner sur votre machine.
date: 2026-09-11
---

# Installation

Téléchargez HeartBeatAgents pour macOS, Windows ou Linux et faites-le fonctionner sur votre machine.

HeartBeatAgents fonctionne entièrement sur votre propre machine : l'installation ne dépend d'aucun compte cloud. Téléchargez-le depuis [https://fr.heartbeatagents.com/download](https://fr.heartbeatagents.com/download). C'est gratuit, aucun compte requis.

## Prérequis : Docker Desktop

Installez d'abord [Docker Desktop](https://www.docker.com/products/docker-desktop/) (gratuit, multiplateforme). HeartBeatAgents utilise Docker pour exécuter les conteneurs locaux qui isolent l'environnement d'exécution de chaque agent.

## Choisissez votre installeur

### macOS
Nécessite **macOS 12 Monterey ou version ultérieure**. Disponible pour Apple Silicon (arm64) et Intel (x64) :
- Installeur natif `.dmg`
- Archive `.zip`

### Windows
Nécessite **Windows 10 ou version ultérieure** :
- Installeur `.exe`

### Linux
Compatible avec **Ubuntu 20.04+, Debian 11+, Fedora 36+, ou équivalent**, en x64 et arm64 :
- Paquet `.deb` (Debian/Ubuntu)
- `.AppImage` (toute distribution)
- Image Docker, pour un déploiement auto-hébergé entièrement conteneurisé

## Installer

Téléchargez l'installeur correspondant à votre plateforme et exécutez-le. L'installeur gère automatiquement le reste : aucune configuration manuelle n'est nécessaire.

Chaque téléchargement est fourni avec une **somme de contrôle SHA-256** permettant d'en vérifier l'intégrité avant exécution. Les images Docker sont signées avec `cosign` via GitHub OIDC, ce qui permet à un déploiement auto-hébergé de vérifier la provenance de la même manière.

HeartBeatAgents est gratuit avec vos propres clés API, ou entièrement gratuit de bout en bout si vous exécutez les modèles localement via Ollama.

## Désinstallation

- **macOS** : faites glisser `HeartBeatAgents.app` du dossier Applications vers la Corbeille. La configuration et les données se trouvent dans `~/.heartbeatagents/` ; supprimez aussi ce répertoire si vous souhaitez tout retirer.
- **Windows** : Panneau de configuration → Programmes → Désinstaller un programme → HeartBeatAgents → Désinstaller, ou `winget uninstall HeartBeatAgents` depuis un PowerShell élevé.
- **Linux (.deb)** : `sudo apt remove heartbeat-agents-desktop`, ou `sudo apt purge heartbeat-agents-desktop` pour aussi supprimer la configuration.
- **Linux (.rpm)** : `sudo dnf remove heartbeat-agents-desktop` (ou `yum` sur les distributions plus anciennes).
- **Auto-hébergé / sans interface** : `hba uninstall`, ou manuellement : `cd ~/.heartbeatagents && docker compose down -v && cd ~ && rm -rf ~/.heartbeatagents`.

## Suite

Vérifiez que votre machine respecte les exigences minimales dans [Configuration requise](/fr/docs/getting-started/system-requirements), ou passez directement à [Première configuration](/fr/docs/getting-started/first-setup) si vous êtes prêt à configurer votre premier agent.