# Instalar Niell

Niell está en pre-release. Para Linux x86_64 hay binario precompilado descargable (vía abajo). Para macOS u otras arquitecturas se compila desde fuentes con Rust + LLVM.

## Linux x86_64 — descarga directa (recomendado)

Funciona en cualquier distro con **glibc 2.34+**: Ubuntu 22.04+, Debian 12+, RHEL 9+, Fedora 38+, Arch, openSUSE Leap 15.5+. Requiere también **clang** instalado (Niell invoca a clang para linkear el runtime C con el IR emitido).

```bash
# 1. Instalar clang + xz (si no están)
sudo apt install -y clang xz-utils    # Ubuntu / Debian
# sudo dnf install -y clang xz        # Fedora / RHEL
# sudo pacman -S clang xz             # Arch

# 2. Descargar + descomprimir + ponerlo en PATH
curl -L https://niell.dev/dl/niell-linux-x86_64.xz | xz -d > niell
chmod +x niell
sudo mv niell /usr/local/bin/

# 3. Verificar
niell --help
```

El binario es self-contained respecto a LLVM 18 y al runtime de Niell — no requiere instalar el toolchain de Rust ni LLVM dev libs. Se distribuye comprimido con `xz` (~12 MB descargados; ~48 MB descomprimido).

## macOS — no soportado todavía

Niell pre-release no tiene binario para macOS ni source distribuible públicamente todavía. Es ejercicio de Slice posterior cuando aparezca demanda.

Si quieres probarlo en Mac:
- Pre-requisitos para el camino futuro de "build desde fuentes": Rust toolchain + LLVM 18 vía Homebrew (`brew install llvm@18`). Para `clang`, viene con Xcode Command Line Tools.
- O esperar la release con binario nativo (cross-compile a `x86_64-apple-darwin` y `aarch64-apple-darwin` está en el roadmap).

## Windows — vía WSL2

Niell no soporta Windows nativo todavía — el linker tiene problemas con LLVM static libs en el toolchain MSVC. Roadmap candidato pero diferido a futuro.

Recomendado: **WSL2 con Ubuntu 22.04+** y luego seguir las instrucciones de Linux x86_64 arriba.

```powershell
# PowerShell con permisos de admin:
wsl --install -d Ubuntu-24.04
```

Reinicia, abre "Ubuntu 24.04" desde el menú de inicio, elige usuario + password. Después sigue los pasos de "Linux x86_64 — descarga directa".

Los archivos `.niell` viven dentro del filesystem WSL (`~/...`) para evitar fricción con el split de filesystems.

## Probar el compilador

Crea `hello.niell`:

```niell
action main
  show with "hola, niell"
end
```

Compila y ejecuta:

```bash
niell hello.niell -o hello
./hello
# → hola, niell
```

## Próximos pasos

Una vez que tienes `niell` funcionando, mira [Getting started](getting-started.html) para un tour de 10 minutos, o salta directo a la spec en [01 Sintaxis](01-sintaxis.html).