🗺️ Plan des outils OLYMPUS

Vue globale d'un seul coup d'œil — qui fait quoi, où chercher, comment ça se relie

Version brouillon · 2026-05-10 · `18-WORD` · à itérer avec Vivien

🏠 Métaphore : ta maison OLYMPUS

Imagine ta maison. Tu as 4 espaces principaux : la cave (ARSENAL) où tu stockes les outils tiers téléchargés, la bibliothèque (AGORA) où sont rangés ton code et tes recettes maison, le restaurant (NEXUS) à l'avant qui sert tout ça aux clients, et la vitrine (COCKPIT) avec les belles pages que tu vois dans ton navigateur.

📐 La maison OLYMPUS — vue éclatée

Chaque rectangle contient ses sous-parties (poupée russe). Les flèches épaisses montrent la circulation des données.

⚡ OLYMPUS le système entier — C:\OLYMPUS\ 🛡️ CERBER orchestrateur · choisit l'instance NEXUS active · répond /api/depannage · /api/sante :10000 UP contrôle 🍽️ NEXUS_DEV le serveur — sert tout en HTTP via 1083 endpoints /api/* :10001 instance courante ⚙️ AXIOM (le cerveau interne) 19 spécialistes embarqués · chacun fait 1 truc 🧠 memory · 📅 chronos · 📁 files · 🎤 voice 🌐 web · 🛡️ aegis · 🖥️ desktop · 🌍 network 🚨 vigil · 👁️ observer · 🎓 training · 🎵 orpheus 🐉 mothra · 🥋 kaio_ken · 📢 herald · ⚙️ system 🧬 memozy · 🔔 proactive · 🔌 integrations → chaque module a ses propres routes (/api/voice/*…) 💻 COCKPIT la vitrine · pages HTML • index.html (tableau de bord) • ZEUS.html (Control Center) • fusion_dashboard.html (chats) • 32 widgets / apps • plugins/ + statique/js/ → tout ce que tu vois en navigateur 📚 AGORA la bibliothèque — code Python + MCPs + outils tiers 📦 modules_maison/ vide pour l'instant (prêt pour officegen…) 🔌 connecteurs_maison/ 23 MCPs (olympus-* · mode-dieu ultime · axiom-direct · etc.) 📜 scripts/ monitoring, backup, dismisser, reorganize… 🛠️ ARSENAL la cave aux outils tiers téléchargés • connecteurs_externes : 1 officiel + 13 communautaires (DesktopCommander, OmniParser, SoM, Perplexica…) • design_system : canvas · fluent-ui · gridstack · gsap • templates : home-assistant · gaming_inspirations 🔧 11 mini-serveurs ports 9961-9979 (autonomes) PURE 9961-9965 (python-docx, openpyxl…) COM 9971-9977 (Word/Excel/PPT/PDF…) imports 🧠 MNEMOSYNE la mémoire — doctrine, projets, journal · C:\OLYMPUS\MNEMOSYNE\ 📜 01_LOIS/ règles permanentes • CARTOGRAPHIE_OLYMPUS.md ⭐ • ARCHITECTURE_OLYMPUS.html • VOCABULAIRE · GLOSSAIRE 📡 02_ETAT/ temps réel • FUSION_LIVE.json (chats actifs) • FUSION_INBOX.md (messages) • REX.md · CHATS_REGISTRY 📁 06_PROJETS/ 1 dossier par projet • OFFICE_PIPELINE_WORD ⭐ • FUSION_DASHBOARD · MEMOIRE • PORTABILITE_001 · LGS · etc. 📚 doctrine + journal consultables au besoin • 03_HOWTO · 04_DIAGRAMMES · 04_ROLES • 05_JOURNAL (logs sessions) • 07_PREFS · 08_IMAGES · 09_ARCHIVES 📖 CODEX auto-régénéré · 287 KB NEXUS génère stocké MNEMOSYNE doctrine lue doctrine lue 📍 Tu lis ce plan depuis MNEMOSYNE/01_LOIS/

💡 Lecture facile : CERBER tout en haut (chef d'orchestre) → NEXUS au centre (le restaurant qui sert) qui contient AXIOM (le moteur) et COCKPIT (la vitrine) → AGORA à droite (la bibliothèque qui contient ARSENAL et les mini-serveurs) → MNEMOSYNE en bas (la mémoire qui irrigue tout). CODEX est un pont auto-régénéré entre NEXUS et MNEMOSYNE. Le 📍 jaune clignotant = où tu es maintenant.

🤔 Pourquoi cette séparation ? Pour un naïf

Imagine que tu cuisines un plat. Tu pourrais tout faire dans la même pièce : stocker les épices, préparer, cuire, servir, faire la vaisselle. Ça marche, mais ça devient vite le bordel. Donc tu sépares en pièces avec un rôle précis. Pareil pour OLYMPUS :

🛠️ ARSENAL séparé d'AGORA — pourquoi ?

Parce que ce sont des outils que tu n'as pas écrits toi-même (téléchargés depuis GitHub, propriétaires d'autres). Les mélanger avec ton code maison = tu ne sais plus qui modifie quoi. Si demain tu mets à jour OmniParser, tu remplaces juste ARSENAL/OmniParser/, ton AGORA n'est pas touché.

📚 AGORA séparée de NEXUS — pourquoi ?

Parce qu'AGORA est réutilisable : si tu lances un MCP en stdio (Claude Desktop), un script Python en ligne de commande, ou NEXUS HTTP — ils peuvent tous piocher dans AGORA. NEXUS n'est qu'une des façons d'utiliser ton code. Si NEXUS plante, AGORA reste utilisable.

🍽️ NEXUS séparé du COCKPIT — pourquoi ?

En vrai, COCKPIT est servi par NEXUS (même processus FastAPI). Mais ils ont des rôles différents : NEXUS sert les API JSON, COCKPIT sert les pages HTML pour l'humain. Tu peux modifier une page Cockpit sans casser une route API, et inversement.

🛡️ CERBER au-dessus de NEXUS — pourquoi ?

Si NEXUS plante, qui le relance ? CERBER. C'est un petit serveur séparé qui ne fait que ça : surveiller NEXUS, le relancer, choisir entre NEXUS_DEV (essai) et NEXUS prod (officiel). Tu peux mettre à jour NEXUS en gardant CERBER vivant.

🧠 MNEMOSYNE séparée de tout — pourquoi ?

Parce que c'est ta mémoire long terme. Si tu reboot le PC, NEXUS et CERBER s'arrêtent. Mais MNEMOSYNE = des fichiers sur disque (.md, .json, .html) qui survivent. C'est là que sont tes règles, tes projets en cours, ton journal des sessions. Aucun process ne tourne dedans : c'est juste du rangement persistant.

📖 CODEX au milieu — pourquoi ?

CODEX est généré par NEXUS (qui sait l'état actuel : ports, projets, modules) et stocké dans MNEMOSYNE (donc persistant). C'est un pont vivant : à chaque régénération, il photographie le système. Quand un nouveau chat Claude arrive, il lit CODEX → il connaît instantanément l'état OLYMPUS sans tout demander.

⚙️ Ce que chaque couche fait concrètement (cas réels)

Pour chaque couche, voici une action concrète typique qui s'y passe — pour que tu visualises bien la différence :

🛡️ CERBER (action) : "NEXUS_DEV n'a plus répondu depuis 30 secondes. Je tue son process et je relance le `.bat`." → tu n'as rien fait, le service reprend tout seul.
🍽️ NEXUS (action) : "Reçu `POST /api/god/click {x:400, y:200}`. Je délègue à `god_helpers.click()` qui est dans AGORA. Je renvoie `{ok:true}` au client." → NEXUS est juste le guichet, il transmet.
📚 AGORA — modules_maison (action) : "`officegen.word.build_doc()` est appelée. J'utilise `python-docx` pour créer le `.docx` avec les sections demandées. Je retourne le chemin du fichier." → c'est ici que la vraie cuisine se fait.
🔌 AGORA — connecteurs_maison (action) : "Claude appelle `olympus_office.olympus_office_word_v2_append`. Le MCP fait un `POST` à NEXUS `/api/office/word/v2/append`. Boucle qui marche." → les MCPs sont des wrappers qui parlent à NEXUS pour Claude.
🛠️ ARSENAL (action) : "OmniParser a été cloné depuis GitHub avec ses checkpoints (~2 GB). Quand AGORA en a besoin, il l'importe avec `from arsenal.OmniParser import detect_ui`." → tu télécharges 1 fois, tu utilises 1000 fois.
💻 COCKPIT (action) : "Tu ouvres `http://127.0.0.1:10001/statique/ZEUS.html`. Le navigateur charge la page, qui fait des `fetch('/api/sante')` toutes les 5 sec pour rafraîchir les KPIs." → la vitrine humaine. Ce que tu vois quand tu regardes.
🧠 MNEMOSYNE (action) : "Le chat 18-WORD termine sa session. Il écrit `06_PROJETS/OFFICE_PIPELINE_WORD/01_JOURNAL.md` et inscrit son entrée dans `02_ETAT/FUSION_LIVE.json`. Au prochain chat, c'est lisible." → la mémoire qui passe d'une session à l'autre.
📖 CODEX (action) : "Toutes les 30 minutes, NEXUS appelle `/api/codex/regenerate`. Le module CODEX lit l'état (ports, projets, /openapi.json…) et écrit `MNEMOSYNE/CODEX.html`. Un nouveau chat lit ce fichier au démarrage et a la photo fraîche du système." → c'est l'auto-photographie périodique d'OLYMPUS.

🛠️ ARSENAL

la cave aux outils tiers téléchargés

C:\OLYMPUS\AGORA\ARSENAL\

  • connecteurs_externes/officiels/ anthropic-servers (everything · fetch · filesystem · git · memory · sequentialthinking · time)
  • connecteurs_externes/communautaires/ 13 MCPs : DesktopCommanderMCP, PowerShell.MCP, Windows-MCP, OmniParser, SoM, Perplexica, playwright-mcp, rag-memory-mcp, mcp-omnisearch, ms-365-mcp-server, image-gen-mcp-server, mcp_weather_server, steam-mcp
  • design_system/ canvas, fluent-ui, grapesjs, gridstack, gsap (libs front)
  • templates/ gaming_inspirations, ha-core, ha-frontend, home-assistant
  • INVENTORY_GOD_MODE.md + TES_OUTILS_GOD_MODE.md 3 fichiers de référence sur les outils GOD MODE

📚 AGORA

la bibliothèque (tes modules + MCPs maison)

C:\OLYMPUS\AGORA\

  • modules_maison/ code Python réutilisable — VIDE pour l'instant. Destiné à recevoir un module officegen, etc.
  • connecteurs_maison/ 23 MCPs maison : olympus-god, olympus-office, olympus-memoire, olympus-files, olympus-meta, olympus-projets, mode-dieu-ultime (~129 outils), axiom-direct, mcp-bureau, mcp-codex, mcp-creative, mcp-llm, mcp-nexus-bridge, mcp-web, lgs, diff_god, propagation, pptx-refonte, etc.
  • connecteurs_maison/serveurs_office/ 11 mini-serveurs Office sur ports 9961-9979 (Word PURE/COM, Excel, PPT, PDF, Outlook, Chrome, LibreOffice)
  • scripts/ utilitaires : monitor_nexus.ps1, monitor_ollama.bat, backup_mnemosyne_daily.ps1, office_activation_dismisser.py, etc.

🍽️ NEXUS

le serveur (HTTP API qui sert tous les outils)

C:\OLYMPUS\01_SERVEUR\NEXUS_DEV\ (instance courante)

  • :10000 CERBER orchestrateur, choisit l'instance NEXUS active, /api/depannage
  • :10001 NEXUS_DEV ~1083 endpoints HTTP : /api/god/*, /api/office/*, /api/web/*, /api/voice/*, /api/vision/*, /api/memory/*, /api/llm/*, /api/meta/cartographie, etc.
  • :10001 NEXUS prod instance officielle (souvent IDLE)
  • AXIOM (le cerveau interne — 19 spécialistes) Chaque module est un mini-spécialiste. Ils sont tous chargés au boot de NEXUS et écoutent leurs propres routes. Exemples concrets :
    • memory = stocke et retrouve des souvenirs (Chroma · /api/memory/*)
    • voice = parle (TTS Piper) et écoute (Whisper) · /api/voice/*
    • files = gère les fichiers (lire, écrire, déplacer) · /api/files/*
    • desktop = pilote l'écran (clic, type, screenshot) · /api/god/*
    • web = navigue sur internet (Playwright) · /api/web/*
    • chronos = horloge système, dates, calendrier
    • memozy = mémoire alternative (mem0) · /api/memory/mem0/*
    • aegis = sécurité, garde-fou (refuse les actions risquées)
    • vigil = surveille la santé du système
    • observer = regarde les logs, détecte les erreurs
    • training = apprentissage (modèles IA, fine-tuning)
    • orpheus = audio (musique, voix, génération sonore)
    • mothra = serveur de fichiers gros (vidéos, modèles…)
    • kaio_ken = boost de performance (mode "puissance max")
    • herald = notifications et alertes
    • system = infos OS (CPU, RAM, services, processus)
    • network = réseau (LAN, Tailscale, ports)
    • proactive = actions automatiques sans demande
    • integrations = ponts vers Gmail, Calendar, Fitbit, etc.

💻 COCKPIT

la vitrine (les pages HTML que tu vois)

C:\OLYMPUS\01_SERVEUR\NEXUS_DEV\Cockpit\

  • index.html tableau de bord principal · 32 widgets/apps
  • statique/ZEUS.html Control Center — vue admin avec mermaid + tabs
  • statique/fusion_dashboard.html les chats actifs en temps réel
  • plugins/ les 32 widgets du Cockpit (apps, tuiles…)
  • statique/js/widgets/ code JS des widgets : voix, office, gaming, news, météo, calendar, etc.

🎯 Qui fait quoi exactement ?

Tu veux…Tu vas…Pourquoi
Lancer un nouvel outil tiers (un MCP github) Le télécharger dans ARSENAL/connecteurs_externes/communautaires/ L'ARSENAL est le tiroir des outils externes téléchargés
Écrire un module Python qui sera réutilisé par plusieurs services Le mettre dans AGORA/modules_maison/ AGORA = ta bibliothèque centrale, importable partout
Exposer une fonction comme outil pour Claude Créer un MCP dans AGORA/connecteurs_maison/ + ajouter au .mcp.json Les MCPs sont le format que Claude comprend
Ajouter une route HTTP au serveur Éditer un api_*.py dans NEXUS_DEV/AXIOM/ NEXUS = le restaurant, c'est lui qui sert
Faire une page visuelle Créer un fichier dans NEXUS_DEV/Cockpit/statique/ Le COCKPIT est la vitrine du système
Documenter une règle ou une décision Ajouter dans MNEMOSYNE/01_LOIS/ MNEMOSYNE = la mémoire long terme du projet
Voir tous les outils dispos d'un coup GET /api/meta/cartographie ou ouvrir CARTOGRAPHIE_OLYMPUS.md L'index unifié, anti-doublon

🔌 Ports en écoute (état temps réel)

:10000
CERBER
Orchestrateur · /api/sante
:10001
NEXUS_DEV ⭐
Instance courante · 1083 endpoints
:10001
NEXUS prod
Instance officielle · IDLE
:9961
Word PURE
python-docx (sans Word.exe)
:9962
Excel PURE
openpyxl pur
:9963
PowerPoint PURE
python-pptx pur
:9965
Preview Office
aperçus de fichiers
:9971
Word COM
pilote Word.exe vivant
:9972
Excel COM
pilote Excel.exe
:9973
PowerPoint COM
pilote PowerPoint.exe
:9974
PDF
pypdf + qpdf + pikepdf
:9975
Chrome
Playwright
:9976
Outlook
pilote Outlook.exe
:9977
LibreOffice
alternative gratuite

🔗 Liens & raccourcis

📍 /api/meta/cartographie (live JSON) 📊 /api/manifest/summary 🏷️ /api/manifest/tags 🩺 /api/god/snapshot/light ⚡ ZEUS Control Center 🤝 FUSION dashboard 🛣️ OpenAPI spec brut 🗺️ CARTOGRAPHIE_OLYMPUS.md 🏛️ ARCHITECTURE_OLYMPUS.html 🔁 REX.md 📡 FUSION_LIVE.json
--- _Migre F:->C: par docs_portability_light 2026-05-10_