Saltar al contenido principal

Instalación de Rapid OS

Rapid OS se distribuye como una herramienta de línea de comandos (rapid o python rapid.py). El núcleo de gobernanza está implementado íntegramente en Python y no requiere dependencias externas obligatorias para su funcionamiento básico.

Elige tu método de instalación​

Existen dos vías principales para instalar Rapid OS según tu flujo de trabajo:

flowchart TD
    A[¿Cómo deseas instalar Rapid OS?] -->|Instalación rápida recomendada| B[Instalador Oficial Shell / PowerShell]
    A -->|Entorno Python existente / pip| C[Instalación vía pip / venv]
    A -->|Contribución al proyecto| D[Instalación de Desarrollo editable]

    B --> E[Descarga ~/.rapid-os y deja el ejecutable 'rapid' en el PATH]
    C --> F[Instala binario 'rapid' en el entorno de Python]
    D --> G[git clone + pip install -e .]

1. Instalador rápido por sistema operativo (Recomendado)​

Los instaladores automatizados clonan el repositorio en ~/.rapid-os, fijan la versión estable e instalan un ejecutable rapid en tu PATH. Es el método recomendado si vas a usar shortcuts o hooks: los agentes solo encuentran rapid si es un ejecutable en el PATH, no un alias ni un venv activado en otra terminal.

2. Instalación mediante pip en un entorno virtual​

Si prefieres gestionar Rapid OS dentro de un entorno virtual de Python (venv):

# Crear y activar entorno virtual
python -m venv .venv
source .venv/bin/activate  # En Windows: .venv\Scripts\Activate.ps1

# Instalar desde el repositorio o paquete
python -m pip install git+https://github.com/alyconr/Rapid-OS.git@v3.1.1

Shortcuts en tu carpeta de usuario​

Desde la versión 3.2.0, rapid shortcuts install --global --harness <id> instala /rapid-init y los demás /rapid-* una vez para todos tus proyectos (Claude Code, Codex, Cursor y Antigravity; VS Code no lo admite: RAPID1413), y los instaladores lo preguntan al terminar si el rapid instalado lo tiene. La versión estable v3.1.1 no lo tiene y su instalador no lo ofrece. Comprueba el resultado en Verificación (RAPID1414 si rapid no está en el PATH).

Diferencia entre versión Estable y Desarrollo​

Canales de instalación
  • Versión Estable (v3.1.1): Pinned al tag oficial v3.1.1. Recomendada para producción y equipos de desarrollo.
  • Versión de Desarrollo (main): Obtenida mediante checkout de la rama main en desarrollo activo. Contiene las últimas características antes de su empaquetado formal.

Pasos siguientes​

  1. Revisa los Requisitos del sistema.
  2. Sigue la guía correspondiente a tu sistema operativo.
  3. Ejecuta la Verificación de la instalación para comprobar que el CLI responde correctamente.
  4. Instala los shortcuts en tu proyecto con rapid init --shortcuts (o rapid shortcuts install en un proyecto ya inicializado) y sigue Primeros pasos.