# KAWA OS

Installation automatique du système KAWA - Réseau distribué avec mesh Tailscale.

## Installation rapide

```bash
git clone https://git.du-senegal.com/kawa_bot/kawa.git && cd kawa && ./setup
```

## Structure

```
kawa/
├── setup                 # Script principal (exécuter celui-ci)
├── nixos/               # Modules NixOS
│   ├── kawa.nix         # Module principal KAWA
│   └── default.nix      # Configuration par défaut
├── modules/             # Modules spécifiques
│   ├── kawa-physical.nix  # Machine physique CPU
│   └── kawa-gpu.nix       # Machine avec GPU
├── install/             # Scripts d'installation avancés
│   ├── live.sh          # Mode Live USB
│   └── disk.sh          # Installation sur disque
└── flake.nix            # Nix Flakes
```

## NixOS - Installation

### Option 1: Script automatique (recommandé)

```bash
./setup
# Détecte automatiquement NixOS et configure
```

### Option 2: Manuel - Machine physique CPU

```nix
# /etc/nixos/configuration.nix
{ config, lib, pkgs, ... }:
{
  imports = [
    ./hardware-configuration.nix
    ./modules/kawa-physical.nix
  ];
}
```

Puis:
```bash
sudo nixos-rebuild switch
```

### Option 3: Manuel - Machine avec GPU

```nix
# /etc/nixos/configuration.nix
{ config, lib, pkgs, ... }:
{
  imports = [
    ./hardware-configuration.nix
    ./modules/kawa-gpu.nix
  ];
}
```

## Paramètres configurés

### Headscale (Mesh Tailscale)

| Paramètre | Valeur |
|-----------|--------|
| Serveur | `headscale.du-senegal.com` |
| Fallback | `141.94.23.212` |
| Auth Key | `f43f36ef159b3df799eb316b81bdac1b415c7cc2add174d0` |

### NATS (Bus de messages)

| Paramètre | Valeur |
|-----------|--------|
| Serveur | `100.64.0.1:4222` |
| Cluster | `KAWA` |
| User | `kawa` |
| Password | `kawa123` |

### Syncthing (Synchronisation)

| Paramètre | Valeur |
|-----------|--------|
| VPS Device ID | `AHF53QZ-ZYCQ2K7-556QBZ2-2UAYZL4-QNEQOGZ-PHZQIAG-4ZRXI3P-QLLJNA6` |
| Folders | `kawa-memory`, `kawa-workspace`, `kawa-forge` |

### Ollama (Inférence IA)

| Type | Acceleration |
|------|--------------|
| CPU | `null` |
| GPU NVIDIA | `"cuda"` |

## Services inclus

- ✅ **Tailscale** - Mesh VPN via Headscale
- ✅ **NATS** - Bus de messages distribué
- ✅ **Syncthing** - Synchronisation de fichiers
- ✅ **Ollama** - Inférence IA locale
- ✅ **SSH** - Accès distant

## Détection automatique

Le script `setup` détecte automatiquement:
- NixOS → Configuration NixOS
- Debian/Ubuntu → Installation standard
- Fedora/RHEL → Installation standard
- Arch Linux → Installation standard
- Docker/Container → Mode container
- Machine physique → Génération hostname auto

## Utilisateur par défaut

- **Username:** `kawa`
- **Password:** `kawa2026` (à changer après installation)

---

🜄 **KAWA** - Réseau distribué autonome