Guia de Instalacion¶

Instalar¶

Un solo comando instala rai como binario standalone. No necesita Python, ni entorno virtual, ni paso de activacion.

Linux / macOS¶

curl -fsSL https://github.com/humansys/raise/releases/latest/download/install.sh | bash

Windows¶

PowerShellInstalador (.exe)

irm https://github.com/humansys/raise/releases/latest/download/install.ps1 | iex

Descarga y ejecuta el instalador grafico — no necesita terminal:

Descargar rai-installer-windows-x86_64.exe

El instalador realiza los mismos pasos que el script de PowerShell (verificacion de checksum, registro en PATH) con una interfaz guiada.

Que hace el instalador¶

Descarga binarios precompilados (rai + rai-mcp-pipeline) de GitHub Releases
Verifica checksums SHA-256 de ambos binarios antes de instalar (atomico)
Instala en ~/.local/share/rai/ (Linux/macOS) o %LOCALAPPDATA%\rai\ (Windows)
Crea symlinks en ~/.local/bin/ (Linux/macOS) o registra en el PATH del usuario (Windows)
No requiere Python

Verificar¶

which rai         # deberia mostrar ~/.local/bin/rai
rai --version

Luego entra a tu proyecto y ejecuta:

cd tu-proyecto
rai onboard

Requisitos Previos¶

Git -- el unico requisito obligatorio.
Claude Code -- instalar desde Anthropic para usar los flujos de trabajo de RaiSE.

Fijar una version especifica¶

curl -fsSL https://github.com/humansys/raise/releases/latest/download/install.sh | bash -s -- --version v3.1.0

./install.ps1 -Version v3.1.0

Actualizacion¶

Vuelve a ejecutar el instalador -- es idempotente y realiza un swap atomico:

curl -fsSL https://github.com/humansys/raise/releases/latest/download/install.sh | bash

Vienes de un venv per-project?

Consulta la Guia de Migracion venv-a-binario.

Vienes de RaiSE 2.x?

Consulta la Guia de Migracion 2.x para cambios incompatibles.

Desinstalacion¶

Linux / macOS:

rm -rf ~/.local/share/rai ~/.local/share/rai-mcp-pipeline
rm -f ~/.local/bin/rai ~/.local/bin/rai-mcp-pipeline

Windows:

Remove-Item "$env:LOCALAPPDATA\rai" -Recurse -Force
Remove-Item "$env:LOCALAPPDATA\rai-mcp-pipeline" -Recurse -Force

Esto solo elimina la herramienta rai. Tus proyectos, gobernanza y directorios .raise/ no se tocan.

Problemas comunes¶

Problema	Solucion
`rai` no se encuentra tras instalar	Agrega `export PATH="$HOME/.local/bin:$PATH"` a tu shell profile y reinicia la terminal
Version anterior sigue ejecutandose	Un `.venv` del proyecto puede estar sobreponiendo al binario -- consulta PATH shadowing
`rai doctor` muestra advertencias	Ejecuta `rai doctor --fix` para reparaciones automaticas
`UnicodeEncodeError` al ejecutar `rai` en Windows (consolas en español/LATAM)	La consola usa la pagina de codigos cp1252, que no puede representar algunos caracteres Unicode que escribe `rai`. Configura `PYTHONUTF8=1` para forzar UTF-8. PowerShell (sesion actual): `$env:PYTHONUTF8 = "1"` — para que persista, agrega esa linea a tu `$PROFILE`. CMD: `set PYTHONUTF8=1` antes de ejecutar cualquier comando `rai`. Alternativa: `chcp 65001` cambia la consola a UTF-8 para la ventana actual.

Metodos alternativos de instalacion¶

Para contribuidores trabajando desde source, instalaciones via uv tool, o setups de venv per-project, consulta la seccion de metodos alternativos en la guia de instalacion.

Proximos Pasos¶

Entra al directorio de tu proyecto y ejecuta rai onboard — detecta el estado de tu repo y te dirige al paso correcto:

cd tu-proyecto
rai onboard

Continua con Primeros Pasos — te guia por tu primera sesion y los ciclos de trabajo paso a paso.

Multiples repos? Consulta la guia de flujo multi-repo.