# ☢️ ZIMLOCAL AI : MANUEL DE SURVIE DU SAVOIR ☢️
![Logo ZimLocal AI](static/images/logo.png)

*Version 1.0 - "L'Internet est mort, longue vie à votre Disque Dur"*

Félicitations, survivant ! Si tu lis ceci, c'est que le grand "Blackout" a eu lieu. Les serveurs de Google sont en train de fondre, Wikipedia est un lointain souvenir vaporeux, et les gens se battent dans la rue pour le dernier exemplaire d'une encyclopédie de 1994. 

Mais toi, tu as été prévoyant. Tu as **ZimLocal AI**. Ce document est ton guide pour reconstruire la civilisation (ou au moins gagner au Trivial Pursuit local) depuis ton bunker.

---

## 🧭 1. OBJECTIFS : POURQUOI CE TRUC EST TON MEILLEUR AMI
Dans ce monde sans nuage (cloud), ZimLocal AI te permet de :
*   **Indexer le Savoir Perdu** : Aspirer des téraoctets de données Wikipedia, Wikiversity et même des recettes de cuisine de survie au format ZIM.
*   **Parler à un Cerveau Synthétique** : Grâce à une IA locale, tu peux poser des questions à tes archives comme si tu avais un bibliothécaire (un peu bizarre mais très savant) enfermé dans ton ordinateur.
*   **Confidentialité Totale** : Pas de trackers, pas de cookies, pas de gouvernement qui espionne tes recherches sur "comment filtrer son urine". Tout reste sur ton SSD.
*   **Zéro Connexion** : Ça fonctionne même si les câbles sous-marins ont été grignotés par des dauphins révoltés.

---

## 🛠️ 2. INSTALLATION : MONTER LE BUNKER NUMÉRIQUE

![Installation dans le bunker](static/images/bunker.png)

Avant que les générateurs ne tombent en panne, tu dois préparer ton matériel.


### Pré-requis (Le "Loot") :
1.  **Python** : Le carburant de base. Sans lui, rien ne tourne.
2.  **Ollama** : C'est le cerveau de l'IA. Installe-le avant que le site ne soit inaccessible (ou récupère l'installeur sur une clé USB dans une zone de quarantaine).
3.  **Archives ZIM** : Ce sont tes livres. Sans eux, l'IA est juste un poète qui n'a rien à dire. Mets-les dans le dossier `data/`.

### Mise en route :
1.  **Réunir les dépendances** :
    ```powershell
    pip install fastapi uvicorn httpx libzim jinja2
    ```
2.  **Lancer le cœur du réacteur** :
    ```powershell
    python main.py
    ```
3.  **Accéder à l'interface** : Allume ton navigateur (qui ne sert plus à rien d'autre) et tape `http://localhost:8000`. Si tu as un réseau local dans ton complexe souterrain, tes amis peuvent aussi se connecter via ton IP.

---

## 🔦 3. UTILISATION : EXPLORER LES RUINES DU WEB

### La Chasse aux ZIMs
Mets tes fichiers `.zim` dans le dossier `data/`. Clique sur le bouton **🔄 Réindexer** dans l'interface. Le système va scanner tes archives et indexer chaque article. *Attention : Si tu as 80 Go de Wikipedia, va te faire un café (ou un ragoût de rat), ça peut prendre un moment.*

### Zimbulon (L'IA de Compagnie)
C'est la barre de chat. Pose une question. L'IA va fouiller dans tes archives, extraire les faits, et te répondre.
*   *Exemple : "Comment fabriquer de la pénicilline ?"* 
*   *Zimbulon : "D'après Wikiversité, il vous faut de la moisissure et beaucoup de patience..."*

### L'Explorateur
À gauche, tu as la liste de tes archives. Tu peux naviguer dedans comme dans le bon vieux temps (2024). C'est idéal pour lire des articles au calme pendant que les zombies grattent à la porte.

---

## 🚀 4. AMÉLIORATIONS POSSIBLES (ROADMAP DU FUTUR)
Même dans l'apocalypse, on ne s'arrête pas de coder :
*   **Recherche Sémantique (Embeddings)** : Pour que l'IA comprenne tes questions même si tu fais des fautes de frappe à cause du froid.
*   **Support Multi-médias** : Extraire les images pour voir à quoi ressemblait un chat avant qu'ils ne deviennent tous radioactifs.
*   **Économie d'Énergie** : Optimiser le code pour que ça tourne sur un vieux Raspberry Pi alimenté par une dynamo de vélo.
*   **Export Markdown** : Pour imprimer les fiches de survie et les troquer contre des boîtes de conserve.

---

## ⚠️ 5. MAINTENANCE ET SURVIE DU DISQUE
*   **Espace Disque** : Le fichier `zim_index.db` peut grossir plus vite qu'une rumeur de fin du monde. Garde un œil sur tes Go.
*   **Crash de l'IA** : Si l'IA ne répond plus, vérifie que **Ollama** n'est pas en train de faire une mise à jour imaginaire. Redémarre `main.py` si nécessaire.

**Reste déconnecté. Reste instruit. Reste vivant.** 

![Survie du savoir](static/images/survival_art.png)

*Document rédigé par l'IA Antigravity - Unité de Soutien aux Survivants.*

