---
title: Instalación
summary: Descarga HeartBeatAgents para macOS, Windows o Linux y ponlo en marcha en tu equipo.
date: 2026-09-11
---

# Instalación

Descarga HeartBeatAgents para macOS, Windows o Linux y ponlo en marcha en tu equipo.

HeartBeatAgents se ejecuta enteramente en tu propio equipo: la instalación no depende de ninguna cuenta en la nube. Descárgalo desde [https://es.heartbeatagents.com/download](https://es.heartbeatagents.com/download). Es gratis, no se requiere cuenta.

## Requisito previo: Docker Desktop

Instala primero [Docker Desktop](https://www.docker.com/products/docker-desktop/) (gratis, multiplataforma). HeartBeatAgents usa Docker para ejecutar los contenedores locales que aíslan el entorno de ejecución de cada agente.

## Elige tu instalador

### macOS
Requiere **macOS 12 Monterey o posterior**. Disponible tanto para Apple Silicon (arm64) como para Intel (x64):
- Instalador nativo `.dmg`
- Archivo `.zip`

### Windows
Requiere **Windows 10 o posterior**:
- Instalador `.exe`

### Linux
Compatible con **Ubuntu 20.04+, Debian 11+, Fedora 36+, o equivalente**, tanto en x64 como en arm64:
- Paquete `.deb` (Debian/Ubuntu)
- `.AppImage` (cualquier distribución)
- Imagen Docker, para un despliegue autoalojado totalmente en contenedores

## Instalar

Descarga el instalador de tu plataforma y ejecútalo. El instalador se encarga automáticamente del resto: no se necesita configuración manual.

Cada descarga incluye una **suma de comprobación SHA-256** para verificar su integridad antes de ejecutarla. Las imágenes Docker están firmadas con `cosign` mediante GitHub OIDC, de modo que un despliegue autoalojado puede verificar su procedencia de la misma manera.

HeartBeatAgents es gratis con tus propias claves de API, o completamente gratis de principio a fin si ejecutas los modelos localmente mediante Ollama.

## Desinstalación

- **macOS**: arrastra `HeartBeatAgents.app` desde Aplicaciones a la Papelera. La configuración y los datos residen en `~/.heartbeatagents/`; elimina también ese directorio si quieres borrarlo todo.
- **Windows**: Panel de control → Programas → Desinstalar un programa → HeartBeatAgents → Desinstalar, o `winget uninstall HeartBeatAgents` desde una PowerShell elevada.
- **Linux (.deb)**: `sudo apt remove heartbeat-agents-desktop`, o `sudo apt purge heartbeat-agents-desktop` para eliminar también la configuración.
- **Linux (.rpm)**: `sudo dnf remove heartbeat-agents-desktop` (o `yum` en distribuciones más antiguas).
- **Autoalojado / sin interfaz**: `hba uninstall`, o manualmente: `cd ~/.heartbeatagents && docker compose down -v && cd ~ && rm -rf ~/.heartbeatagents`.

## Siguiente paso

Confirma que tu equipo cumple los requisitos mínimos en [Requisitos del sistema](/es/docs/getting-started/system-requirements), o pasa directamente a [Configuración inicial](/es/docs/getting-started/first-setup) si ya estás listo para configurar tu primer agente.