# Installazione — Liu Terminal

> Installa Liu Terminal su macOS. Scarica la DMG per Apple Silicon o Intel, oppure installa tramite Homebrew.

URL: https://liu.software/it/docs/install/  
Language: it  
Updated: 2026-10-17

Installa Liu su macOS o Linux — scarica una build pacchettizzata dal menu download o compila dal sorgente in meno di un minuto.

## Installa

Scarica una build pacchettizzata dal menu download (macOS .dmg per Apple Silicon / Intel, .tar.gz di Linux) o usa un gestore di pacchetti:

```
# macOS (Homebrew)
brew install --cask calculusteam/liu/liu

# Arch (AUR)
paru -S liu-bin

# Debian/Ubuntu (PPA)
sudo add-apt-repository ppa:calculusteam/liu && sudo apt update && sudo apt install liu

# Fedora (COPR)
sudo dnf copr enable calculusteam/liu && sudo dnf install liu
```

I comandi dei gestori di pacchetti riguardano repository che potrebbero non essere pubblicati a ogni release. Il percorso di build dal sorgente funziona indipendentemente.

Le build macOS sono firmate con Developer ID e notarizzate da Apple: Liu.app si apre senza alcun avviso di Gatekeeper.

Oppure installa l'ultima build firmata tramite lo script (ripiego):

```
curl -fsSL https://raw.githubusercontent.com/calculusteam/liu/main/scripts/install.sh | bash
```

## Compila dal sorgente

Dalla radice del repository, l'helper di build rileva la piattaforma e seleziona di default una baseline Release:

```
./scripts/build.sh --yes      # recommended non-interactive build
./scripts/build.sh --debug    # Debug build
./scripts/build.sh --native   # host CPU tuning
./scripts/build.sh --package  # Release build + macOS DMG/Linux tarball
```

Il percorso CMake diretto è:

```
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j$(sysctl -n hw.ncpu 2>/dev/null || nproc)
./build/Liu
```

## Prerequisiti

- CMake 3.20+
- Un compilatore C11 - Apple clang, clang mainline o gcc 10+
- `libssh2` (libreria di sistema o build vendorizzata, scelta da CMake)
- Linux richiede anche pacchetti di sviluppo OpenSSL/libcrypto, X11 e OpenGL. Esempio Debian/Ubuntu: libssh2-1-dev libssl-dev libx11-dev libxcursor-dev libxrandr-dev libgl-dev pkg-config.

SQLite3, stb\_truetype, stb\_image e cJSON sono integrati in third\_party/ - non è necessario installarli separatamente.

## macOS — Obiettivo principale

```
brew install libssh2
git clone https://github.com/calculusteam/liu.git && cd liu

cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j$(sysctl -n hw.ncpu)

./build/Liu
```

Le build Release aggiungono LTO e -O3. Il default è una baseline portabile; passa -DLIU\_NATIVE\_ARCH=ON a cmake per -march=native su x86\_64 (Apple arm64 usa -mcpu=apple-m1). Per il debug, sostituisci Release con Debug.

## Linux

```
sudo apt install cmake build-essential libssh2-1-dev
git clone https://github.com/calculusteam/liu.git && cd liu

cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j$(nproc)

./build/Liu
```

Il backend Metal viene saltato al di fuori di macOS; ottieni il renderer core OpenGL 3.3. Passa -DUSE\_METAL=OFF anche su macOS se vuoi forzare OpenGL.

## Flag utili

```
cmake -B build -DUSE_ASM=OFF        # salta l'assembly SIMD
cmake -B build -DUSE_METAL=OFF      # forza OpenGL su macOS
cmake -B build -DUSE_LIBFUZZER=ON   # abilita gli harness libFuzzer
```

```
cmake -B build -DLIU_NATIVE_ARCH=ON       # tune Release for this CPU
cmake -B build -DLIU_BROWSER=OFF             # disable the macOS WebKit browser
cmake -B build -DUSE_VENDORED_SSH_DEPS=OFF  # use system SSH/crypto deps
cmake -B build -DAUTO_DOWNLOAD_SSH_DEPS=OFF # do not bootstrap missing macOS deps
```

## Binari complementari

Una singola build di primo livello produce due binari fratelli accanto all'app principale:

```
cmake --build build --target liu-notify   # demone di notifica + CLI
cmake --build build --target liu-history  # CLI autonoma per la cronologia agenti
```

## Pacchettizzazione (macOS)

```
./scripts/build_macos_compat_deps.sh    # integra libssh2 + OpenSSL
./scripts/package_macos_dmg.sh          # .app firmato + DMG
```

## Terminfo personalizzato

Liu fornisce la propria voce di terminale in modo che le shell remote pubblicizzino le capacità corrette: truecolor, modalità mouse, incolla tra parentesi, output sincronizzato Mode 2026, OSC 7/8/133.

```
tic -x liu.terminfo
```

[Prossimo Avvio rapido →](https://liu.software/it/docs/quickstart.md)