Instalá Gentle Shell
Leé esta lección acá, en el sitio web: hasta que Gentle Shell esté instalado no hay
un agente donde pegar un prompt. El objetivo es acotado y observable: hacer que el
comando gentle-shell esté disponible y después confirmarlo con
gentle-shell --version.
Empezá por identificar tu sistema operativo. El instalador de descarga documentado es el camino más simple y no necesita terminal. Instala las piezas que necesita Gentle Shell, o actualiza una instalación existente, y muestra un plan antes de cambiar nada. Descargalo solamente desde la página Releases del repositorio de Gentle Shell.
Usá el instalador para tu sistema
Elegí el archivo documentado para tu sistema operativo:
- macOS: descargá
gentle-shell-installer-macos.zip, abrilo y luego hacé doble clic en Install Gentle Shell.command en la carpeta Gentle Shell Installer. - Windows: descargá
gentle-shell-installer-windows.zip, hacé clic derecho y elegí Extract All, luego abrí la carpeta extraída Gentle Shell Installer y hacé doble clic en Install Gentle Shell.cmd. No lo ejecutes desde dentro del archivo zip. - Linux: descargá
gentle-shell-installer-linux.tar.gz, extraelo y luego hacé doble clic eninstall-gentle-shell.sh. Si tu administrador de archivos abre el script en un editor, ejecutá este comando en la carpeta extraída:
sh install-gentle-shell.sh
El instalador abre una ventana pequeña y luego una página del navegador. Mantené
esa ventana pequeña abierta hasta que el navegador indique que la instalación
terminó. En una instalación nueva empaquetada, Gentle Shell conserva su propio
Node.js, npm, pnpm y Pi en ~/.gentle-shell; no usa ni modifica tus propias
herramientas.
Los instaladores descargables actualmente no están firmados, por lo que macOS o Windows podrían advertirte la primera vez. Seguí las indicaciones del sistema operativo en el README de Gentle Shell enlazado desde el release, en lugar de eludir una advertencia inesperada. Si tu sistema operativo no es macOS, Windows ni Linux, seguí el enlace Get started del README para un recorrido documentado; este curso no inventa uno.
Confirmá el comando
Cuando termine el instalador, abrí una terminal nueva si te lo pide y luego ejecutá:
gentle-shell --version
Un comando exitoso muestra información de versión de Gentle Shell, Pi y home. Esa es la comprobación de esta lección: prueba que tu terminal puede encontrar el lanzador. Si el comando no se encuentra o no muestra información de versión, volvé al resultado del instalador y a su guía documentada en lugar de adivinar cambios de PATH o comandos de paquetes.
Otros recorridos documentados
El README también documenta un recorrido npm independiente y otro para agregar el paquete a una instalación existente de Pi. Son decisiones útiles de propiedad, pero el instalador descargable es el recorrido enseñado acá porque está documentado para los tres sistemas operativos compatibles. Leé la sección Get started del README si necesitás deliberadamente alguna de esas alternativas.
Probalo
Seguí el recorrido del instalador para tu sistema operativo y ejecutá
gentle-shell --version. Cuando muestre información de versión, continuá con
Abrí Gentle Shell: iniciá Gentle Shell y te muestra dónde pegar tu primer prompt.