kawa/README.md

KAWA OS

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

Installation rapide

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é)

./setup
# Détecte automatiquement NixOS et configure

Option 2: Manuel - Machine physique CPU

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

Puis:

sudo nixos-rebuild switch

Option 3: Manuel - Machine avec GPU

# /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	<HEADSCALE_AUTHKEY>

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