# Instalación {#installation} > Instala, comprueba, actualiza o desinstala Clarvis v0.1.1. La descarga portátil incluye todo lo necesario para ejecutar Clarvis, incluido Bun y las dependencias nativas del terminal. No necesitas instalar Bun, Node.js, un compilador ni un gestor de paquetes. Tampoco necesitas permisos de administrador ni descargar el código fuente. > `v0.1.1` es una versión pública oficial `0.x`. Las interfaces y los formatos guardados aún pueden cambiar antes de `1.0`. Los binarios todavía no están firmados ni notarizados. Los comandos de esta página corresponden a la versión inmutable `v0.1.1`. Utiliza la suma de comprobación, el archivo comprimido y el instalador de esa misma versión. ## Versión actual {#current-release} [`Clarvis v0.1.1`](https://github.com/getclarvis/clarvis-releases/releases/tag/v0.1.1) se publica en el repositorio de binarios [`getclarvis/clarvis-releases`](https://github.com/getclarvis/clarvis-releases). Incluye los seis archivos portátiles, los instaladores POSIX y PowerShell de esa versión, [`SHA256SUMS`](https://github.com/getclarvis/clarvis-releases/releases/download/v0.1.1/SHA256SUMS) y los avisos de licencia correspondientes. ## Sistemas y arquitecturas disponibles {#supported-release-targets} | Sistema operativo | Arquitecturas | Identificador del paquete | Comprobaciones automáticas | | ----------------- | -------------------- | ------------------------------ | ---------------------------------------------------- | | Linux (glibc) | x64, arm64 | `linux-x64`, `linux-arm64` | Paquete, instalación y primera pantalla del terminal | | macOS | Intel, Apple silicon | `darwin-x64`, `darwin-arm64` | Paquete, instalación y primera pantalla del terminal | | Windows | x64, arm64 | `windows-x64`, `windows-arm64` | Paquete, instalación y comandos básicos de la CLI | Las pruebas de publicación cubren el empaquetado y la instalación de los seis destinos y verifican que los paquetes públicos no incluyan mapas de código fuente. En Linux y macOS también comprueban la primera pantalla en un pseudoterminal (PTY). En Windows comprueban el manifiesto, `--version`, `--help`, la instalación y la reinstalación. Estas pruebas no sustituyen abrir manualmente la interfaz de Windows ni comprobar los avisos de SmartScreen. Para ejecutar sin interfaz interactiva, usa `clarvis -p`. ## Linux y macOS {#linux-and-macos} Se necesitan `tar`, `mktemp`, `curl` y `sha256sum` o `shasum`. Los paquetes de Linux son para GNU/glibc; estos archivos portátiles no admiten Alpine ni otras distribuciones que solo usen musl. Instala la versión publicada con: ```bash curl -fsSL https://github.com/getclarvis/clarvis-releases/releases/download/v0.1.1/install.sh | sh ``` Si prefieres revisar el instalador antes de ejecutarlo, descarga el de la misma versión, examínalo y ejecútalo después: ```bash curl -fL https://github.com/getclarvis/clarvis-releases/releases/download/v0.1.1/install.sh -o install.sh vi ./install.sh sh ./install.sh ``` La instalación gestionada se guarda por defecto en `${XDG_DATA_HOME:-$HOME/.local/share}/clarvis`. Se coloca un pequeño lanzador en `${CLARVIS_BIN_DIR:-${XDG_BIN_HOME:-$HOME/.local/bin}}/clarvis`. El instalador no modifica los archivos de inicio del intérprete de comandos. Si el directorio del lanzador no está en `PATH`, muestra la línea necesaria para añadirlo; puede ser necesario abrir un terminal nuevo. ## Windows PowerShell {#windows-powershell} Windows necesita PowerShell con `Invoke-RestMethod` (`irm`), `Invoke-Expression` (`iex`), `Invoke-WebRequest`, `Get-FileHash` y el `tar.exe` del sistema. Instala la versión publicada con: ```powershell irm "https://github.com/getclarvis/clarvis-releases/releases/download/v0.1.1/install.ps1" | iex ``` Para revisar primero el instalador, descarga el archivo de la misma versión inmutable: ```powershell Invoke-WebRequest -Uri "https://github.com/getclarvis/clarvis-releases/releases/download/v0.1.1/install.ps1" -OutFile ".\install.ps1" notepad .\install.ps1 & .\install.ps1 ``` La instalación gestionada usa por defecto `%LOCALAPPDATA%\Clarvis`. Su directorio `bin` se añade al `PATH` del usuario, salvo que hayas definido `CLARVIS_SKIP_PATH=1`. Si no se encuentra `clarvis` inmediatamente, vuelve a abrir el terminal. ## Qué comprueba el instalador {#what-the-installer-verifies} Para el sistema operativo y la arquitectura detectados, el instalador: 1. descarga el archivo `.tar.gz` correspondiente y `SHA256SUMS` de la misma versión; 2. exige una única entrada de suma de comprobación y verifica los bytes descargados; 3. extrae el contenido en un directorio privado de preparación; 4. comprueba que la CLI preparada indique la versión solicitada; 5. se niega a sustituir un comando ajeno o un lanzador POSIX de otra instalación; 6. activa la nueva versión solo cuando todas las comprobaciones han pasado. Antes de cada fase de descarga, verificación, extracción, prueba de la CLI y activación, muestra la versión, el destino detectado, las rutas y una línea numerada de estado. Cada paquete incluye un manifiesto `release.json` con la ruta, el tamaño y el SHA-256 exactos de todos sus archivos. Clarvis vuelve a verificarlo antes de activar una actualización. Para comprobar un paquete manualmente, descarga el archivo y `SHA256SUMS`, localiza la línea cuyo nombre coincida exactamente y utiliza la herramienta SHA-256 del sistema. No instales el paquete si el nombre o la suma no coinciden. ## Ejecutar y actualizar {#run-and-update} ```bash clarvis --version cd /path/to/project clarvis clarvis --update ``` El actualizador solo funciona en instalaciones portátiles gestionadas. No se ejecuta automáticamente al iniciar Clarvis. Prepara y verifica la nueva versión, conserva la anterior y cambia la versión activa al final. Las copias del código fuente y las instalaciones con `bun link` rechazan la actualización automática: actualízalas mediante Git y el entorno de desarrollo. Una versión preliminar puede actualizarse a otra preliminar más reciente o a una versión estable posterior. Una instalación estable no selecciona versiones preliminares. ## Binarios sin firma {#unsigned-binaries} Los binarios de `v0.1.1` no están firmados ni notarizados. Gatekeeper de macOS o SmartScreen de Windows pueden solicitar confirmación para abrir una aplicación descargada. Lee el aviso, comprueba la URL y el SHA-256 y utiliza la interfaz normal de aprobación del sistema. Los instaladores de Clarvis no desactivan ni eluden estas protecciones. ## Desinstalar Clarvis {#remove-clarvis} Los instaladores públicos de `v0.1.1` incluyen un modo de desinstalación con comprobaciones de seguridad. Descarga el instalador de esa misma versión antes de ejecutar el comando. Linux o macOS: ```bash curl -fL https://github.com/getclarvis/clarvis-releases/releases/download/v0.1.1/install.sh -o install.sh sh ./install.sh --uninstall ``` Windows PowerShell: ```powershell Invoke-WebRequest -Uri "https://github.com/getclarvis/clarvis-releases/releases/download/v0.1.1/install.ps1" -OutFile ".\install.ps1" & .\install.ps1 -Uninstall ``` El desinstalador muestra qué va a eliminar y comprueba que los archivos pertenezcan a la instalación seleccionada. Usa el mismo bloqueo exclusivo que las instalaciones y actualizaciones; rechaza archivos ajenos o que estén cambiando al mismo tiempo. En POSIX, el lanzador debe apuntar a la carpeta seleccionada. Elimina las versiones gestionadas, `current`, el marcador de instalación y el lanzador correspondiente. En Windows también quita la entrada gestionada de `bin` del `PATH` del usuario, aunque ya falte el lanzador. Usa `CLARVIS_SKIP_PATH=1` para no modificar `PATH`. Rechaza directorios gestionados que sean enlaces y destinos de marcador o activación que no sean archivos. Si cancelas, libera el bloqueo antes de salir. Conserva e identifica los archivos desconocidos y los lanzadores ajenos. Puedes repetir la desinstalación sin cambios, aunque queden esos archivos conservados. La configuración y las credenciales se guardan por defecto en `~/.clarvis` o `%USERPROFILE%\.clarvis`, fuera de la instalación del binario. Desinstalar la aplicación no las elimina. Bórralas solo después de hacer una copia de lo necesario y confirmar que ya no necesitas las credenciales ni las sesiones. Si cambiaste las rutas de instalación, pasa los mismos valores de `CLARVIS_INSTALL_ROOT` y, en POSIX, `CLARVIS_BIN_DIR` al desinstalador de esa versión. Las variables se documentan en los archivos publicados `install.sh` e `install.ps1`. --- [HTML canónico](https://clarvis.dev/es-ES/installation) [Índice de documentación](https://clarvis.dev/es-ES/llms.txt)