⚡ DOCUMENT MAÎTRE v10.1.0 — 25/04/2026

OLYMPUS — Architecture & Vocabulaire

Schéma de principe · Ports · Protocoles · Légende · Incohérences

🏛️ Schéma global

OLYMPUS = CERBER + NEXUS. NEXUS = COCKPIT + ZEUS + AXIOM. AXIOM puise dans l'AGORA (qui contient l'ARSENAL).

📚 Légende des termes

Terme	Définition	Exemple / Localisation
OLYMPUS	Système complet — 1 instance autonome	`C:\OLYMPUS\`
CERBER	Launcher — orchestre les NEXUS	`http://127.0.0.1:10000`
NEXUS	Serveur fusionné = COCKPIT + ZEUS + AXIOM (1 process)	`http://127.0.0.1:10001`
COCKPIT	UI principale — là où l'utilisateur travaille (affiche les TUILES)	`C:\OLYMPUS\01_SERVEUR\NEXUS\Cockpit\statique\cockpit_classique.html` servi via `/statique/cockpit_classique.html`
ZEUS	« Cockpit d'AXIOM » — console méta-données NEXUS (fichiers, sauvegardes, état). Vue admin/superviseur.	`C:\OLYMPUS\01_SERVEUR\NEXUS\Cockpit\statique\ZEUS.html` servi via `/statique/ZEUS.html`
AXIOM	Cœur logique Python — le vrai cerveau	`C:\OLYMPUS\01_SERVEUR\NEXUS\AXIOM\`
NOYAU	Orchestrateur central d'AXIOM	`axiom/__init__.py`
MODULE	Composant fonctionnel Python (machine)	weather, memory, voice, vision...
FONCTION	Action unitaire d'un module (bouton de la machine)	`get_weather(city)`
CONNECTEUR	Prise MCP bidirectionnelle (consomme ET offre)	olympus-god, gmail-mcp, chrome-mcp
BANQUE	Stockage persistant de connaissances	Chroma, mem0, projets.json
AGORA	Dossier backend partageable (modules + connecteurs + arsenal)	`C:\OLYMPUS\AGORA\`
ARSENAL	Sous-dossier AGORA = outils TIERS téléchargés	`AGORA\ARSENAL\`
GARAGE	Bibliothèque des TUILES UI dispo dans le COCKPIT	base interne du cockpit
TUILE	Élément visuel du COCKPIT — 3 modes : • aperçu = slot statique compact dans la grille • widget = carré flottant détaché ½ transparent (sur le bureau) • application = plein écran, plug-and-play, exportable PWA mobile	Tuile YouTube, Tuile Sphère, Tuile Météo...
PARTAGE	Passerelle de transfert entre 2 NEXUS (MAJ)	NEXUS_DEV → NEXUS_PROD
mcp_factory	Fabrique à connecteurs (générateur de code MCP)	`AXIOM\mcp_factory.py`

🌐 Ports & URLs

Composant	Port	URL	Statut actuel
CERBER	10000	`http://127.0.0.1:10000`	actif
CERBER bus UDP	9998	`UDP fédération inter-CERBER`	réservé
CERBER sortie HTTPS	9999	`HTTPS Cloudflare tunnel`	réservé
NEXUS prod	10002	`http://127.0.0.1:10001`	actif — chantier en cours
NEXUS_DEV	10001	`http://127.0.0.1:10001`	parallèle, ignoré pour l'instant
COCKPIT	(via NEXUS)	`:10001/statique/cockpit_classique.html`	actif
ZEUS	(via NEXUS)	`:10001/statique/ZEUS.html`	actif
API AXIOM	(via NEXUS)	`:10001/api/*`	462 endpoints
Réseau LAN	10002	`http://192.168.1.80:10001`	accessible LAN
AXIOM 2.1 legacy	9110	`http://127.0.0.1:9110`	actif, NON migré
LAN binding	0.0.0.0	NEXUS bind sur toutes interfaces	actif

🔌 Protocoles de communication

De	→	Vers	Protocole	Exemple
AXIOM	→	MODULE Python	import direct	`from agora.modules_maison.weather import get_weather`
AXIOM	→	BINAIRE ARSENAL	subprocess	`subprocess.run(["es.exe", "*.pdf"])`
AXIOM	→	SCRIPT ARSENAL	subprocess	`subprocess.run(["python", "tool.py"])`
AXIOM	→	MCP externe (chrome, gmail)	MCP client (stdio)	NEXUS lance le subprocess MCP et lui parle en JSON-RPC
COCKPIT / ZEUS	→	AXIOM	HTTP REST (local)	`fetch('/api/health')`
Claude Desktop	→	CONNECTEUR maison	MCP (stdio)	Claude lance `python mcp_olympus_god.py`
CONNECTEUR maison	→	AXIOM	HTTP REST	`requests.post('http://127.0.0.1:10001/api/god/eyes')`
Ollama / LLM local	→	AXIOM	HTTP REST ou MCP	via tools-calling Ollama ou wrapper MCP
GPT API / autres	→	AXIOM	HTTP REST	function-calling vers `/api/*`
App mobile (futur)	→	AXIOM	HTTP REST + PWA	Application installable depuis NEXUS
NEXUS_DEV	→	NEXUS prod	PARTAGE (copier-coller)	Transfert AGORA + config (futur)

🛒 AGORA — structure de fichiers

C:\OLYMPUS\AGORA\
│
├── _index.json              ← liste maître (lue au démarrage par tous les chats)
├── README.md                ← doc d'usage
│
├── modules_maison/          ← code Python interne (réutilisable)
│   ├── memory/
│   │   └── core.py          ← fonctions: add_memory, search_memory...
│   ├── weather/
│   │   └── core.py
│   └── ...
│
├── connecteurs_maison/      ← MCPs faits avec mcp_factory.py
│   ├── olympus-god/
│   │   └── mcp_olympus_god.py
│   ├── olympus-meta/
│   │   └── mcp_olympus_meta.py
│   └── ... (futurs)
│
└── ARSENAL/                 ← outils TIERS (pas faits maison)
    │
    ├── connecteurs_externes/  ← MCPs téléchargés (officiels + open-source)
    │   ├── officiels/
    │   │   ├── filesystem/
    │   │   ├── memory/
    │   │   └── ...
    │   └── communautaires/
    │       ├── DesktopCommanderMCP/
    │       ├── chrome-mcp/
    │       ├── gmail-mcp/
    │       └── ...
    │
    ├── binaires/              ← .exe standalone
    │   ├── everything/
    │   ├── ffmpeg/
    │   └── yt-dlp/
    │
    └── scripts/               ← .py .ps1 .bat utilitaires
        ├── scan_pc/
        └── ...

⏱️ Actuel vs Cible

📍 Actuel (phase alpha)

1 dossier C:\OLYMPUS\ contient :

1 CERBER (port 10000)
2 NEXUS qui s'activent intelligemment en alternance (pas simultanément) :
- NEXUS prod (10002) — chantier en cours
- NEXUS_DEV (10001) — vaisseau spatial mère, ignoré pour l'instant
"Œuf à 2 jaunes" : 1 OLYMPUS qui héberge 2 NEXUS
Vieux OLYMPUS sur C:\ — migré sur F:\ (25/04)
AXIOM 2.1 :9110 — legacy encore actif, NON migré, à traiter plus tard

🎯 Cible (à terme)

2 OLYMPUS séparés physiquement :

OLYMPUS prod = 1 CERBER + 1 NEXUS (autonome)
OLYMPUS dev = "vaisseau spatial mère"
- vient livrer les MAJ via PARTAGE
- repart après
Chaque OLYMPUS = système étanche, son propre AGORA
Migration via copier-coller

📜 Doctrine — Fonction vs Connecteur

Critère	Décision
Claude (ou un LLM externe) doit l'appeler	CONNECTEUR
Tu veux pouvoir l'exporter un jour	CONNECTEUR (préventif)
Seul AXIOM l'utilise en interne	FONCTION
Plomberie technique (parsing, hash, format)	FONCTION

Promotion gratuite : une fonction peut être transformée en connecteur en 30 secondes via mcp_factory.py. Pas de regret possible. On commence souple.

🔄 NEXUS = client ET serveur MCP

⬇️ NEXUS comme SERVEUR MCP (offre)

NEXUS expose ses outils via les connecteurs_maison :

olympus-god → 14 outils (eyes, exec, click...)
olympus-meta → search/call les 462 endpoints
... (autres à fabriquer via mcp_factory)

Les consommateurs : Claude Desktop, Cline, Cursor, Ollama tools-call.

⬆️ NEXUS comme CLIENT MCP (consomme)

NEXUS lance et appelle des MCPs externes depuis ARSENAL/connecteurs_externes :

chrome-mcp → contrôler Chrome sans passer par Claude
gmail-mcp → lire/envoyer mails directement
drive-mcp → fichiers Google Drive
... (toute la BANQUE_MCP)

Avantage : NEXUS devient autonome, plus dépendant de Claude pour ces actions.

📊 Inventaire complet (état réel 25/04/2026)

⚙️ Backend AXIOM

15 tranches API (1, 1b, 2-14)
457 endpoints actifs
19 modules Python (v1.0.4 — était 24 en v10.1.0)
3 modules avec API dédiée (aegis, orpheus, memozy)

🎨 Frontend COCKPIT

32 widgets dans js/widgets/
~20 pages dans Cockpit/statique/
Skin Xbox 2018 lignes CSS (signature)
WidgetRegistry framework de mount

🔌 Connecteurs MCP existants

6 olympus-* maison (god, meta, projets, memoire, office, files)
17 dans BANQUE_MCP (7 officiels + 10 communautaires)
~24 MCP wrappés historique (Mozart 0.75)
mcp_factory.py = générateur 30sec

🧠 Les 19 modules d'AXIOM (v1.0.4 · source live : /api/modules)

🛡️ Système

aegis — trust + sécurité
system — apps, ports, processes, services, storage, tasks, registry, perf...
vigil — surveillance
observer — observation
file_watcher — surveillance FS

🧠 Mémoire & Cognition

memory — Chroma + mem0 + rêves nocturnes + RAG sémantique
memozy — souvenirs structurés
chronos — temps + rythmes
kaio_ken — pipeline raisonnement
scribe — résumés

🌐 Communication

integrations — Gmail, Calendar, Telegram, Xbox, Fitbit, ebay, weather, news, finance, solar, cameras, homeassistant, gmail_filters
web — fetch + search
network — scan, devices_hub
herald — annonces

🎤 Voix & Vision

voice — STT + TTS + commandes
orpheus — pipeline vocal complet (server, stt, tts, vad)
desktop — capture + UIA
presentation — accueil welcome

📁 Fichiers & Maintenance

files — backup, cleanup, organize, scan, search
mothra — runtime géant
training — entrainement
proactive — monitoring proactif

🔧 Outils internes

telemetry — métriques
audit — audit_pc_ollama
_compat — rétro-compat

💾 BANQUES (mémoire persistante)

BANQUE	Type	Localisation	Rôle
Chroma	Vector DB	`C:\MODELES_IA\memory_hub\chroma`	Mémoire sémantique long terme — réinjecte ~500 tokens à chaque message via hook UserPromptSubmit
mem0	Memory layer	via `modules/memory/mem0.py`	Layer drop-in personnalisable
Rolling Checkpoint	Snapshot	tag `chat-N-tag-YYYYMMDD`	~100 tokens compacts injectés au démarrage chat
projects.json	JSON DB	`AXIOM/data/projects.json`	Liste des projets actifs
ui_catalog.json	JSON catalog	`AXIOM/data/ui_catalog.json`	Catalog des 716 items UI (552 placés + 164 divers à reventiler)
codex_meta.json	Metadata	`MNEMOSYNE/_STATS/codex_meta.json`	État dernière régénération CODEX

💻 Machine cible

Élément	Valeur
Utilisateur	Vivien Panza (vivienPC)
OS	Windows 10/11
RAM	33 GB
Disque C:	1 TB (vieux OLYMPUS migré, à archiver)
Disque F:	512 GB ("super clé Vivien" — racine OLYMPUS actuelle)
IP LAN	192.168.1.80
Email	vivienpanza@gmail.com
Pseudo gamer	Dc+Psy+KoPaT (Xbox)

🚨 Incohérences détectées (audit 25/04 — à corriger v10.1.0)

#	Sujet	Conflit	Criticité	Décision v10.1.0
1	widget / tuile / app	HERITAGE 24/04 disait "plus de widget/tuile, juste app". Doctrine 25/04 dit "TUILE = élément à 3 modes (aperçu/widget/application)"	HAUTE	Doctrine 25/04 prime — widget et application deviennent des MODES de TUILE
2	MODULE	HERITAGE : "libraries/utils invisibles". Guide NEXUS : "composant fonctionnel (mémoire, voix...)"	HAUTE	Guide NEXUS prime — MODULE = composant fonctionnel
3	NEXUS_DEV	HERITAGE : "instance test". Doctrine 25/04 : "vaisseau spatial mère"	moyenne	Doctrine 25/04 prime — temporaire, livre les MAJ puis se retire
4	Endpoints comptés	GOD v10.0.1 (23/04) : 473 endpoints. Récap (25/04) : 462	à vérifier	Audit Phase B1 — comptage réel à faire
5	Versions	GOD = v10.0.1, MEMORY = v10.1.0, pas de v10.0.2 documentée	moyenne	Bump direct vers v10.1.0 (changements majeurs justifient saut mineur)
6	Dossier `Cockpit/` (majuscule)	Dossier physique = conteneur (ZEUS+cockpit_classique+autres). Concept = COCKPIT seul	moyenne	À renommer plus tard (ex: `web/` ou `statique/`) — pas urgent
7	GARAGE	HERITAGE : "garage de 45 apps". Doctrine : "bibliothèque des TUILES UI"	cohérent	OK — c'est la même chose dit autrement
8	AXIOM 2.1 :9110	GOD v10.0.1 : "ancienne app à ne pas toucher". Aujourd'hui : "encore actif, non migré"	moyenne	Garder en marche, migrer plus tard (chantier dédié)
9	OLYMPUS_COMMAND_CENTER.html	Existe + déjà marqué obsolète	OK	Rien à faire (déjà marqué)
10	CORTAVIS_COCKPIT.html	2 versions différentes (15Ko vs 88Ko)	obsolète de ouf	Marquer les 2 versions obsolètes (Phase C)

📝 Changelog v10.1.0 → v10.1.0

✨ Nouveautés

📦 AGORA — nouveau dossier backend partageable (modules + connecteurs + ARSENAL)
📦 ARSENAL — sous-dossier AGORA pour outils tiers téléchargés
🔄 NEXUS = client ET serveur MCP (bidirectionnel : consomme chrome/gmail + offre olympus-*)
📜 Doctrine "fonction par défaut, connecteur à la demande" (via mcp_factory)
📚 Vocabulaire stabilisé : OLYMPUS, CERBER, NEXUS, COCKPIT, ZEUS, AXIOM, NOYAU, MODULE, FONCTION, CONNECTEUR, BANQUE, AGORA, ARSENAL, GARAGE, TUILE, PARTAGE
🎨 TUILE = 3 modes (aperçu / widget / application)
⚡ ZEUS clarifié comme "cockpit d'AXIOM"

🔧 Corrections

HERITAGE_DISPATCH section vocabulaire patchée (widget/tuile/app)
MODULE redéfini (composant fonctionnel ≠ libraries)
Migration ancien OLYMPUS C:\ → F:\ effectuée 25/04

⚠️ Obsolescences marquées

GOD_OLYMPUS_v10.0.1.html (remplacé par CODEX vivant + ce document)
CORTAVIS_COCKPIT.html (2 versions, remplacement total)
HERITAGE_DISPATCH_24042026.md sections 1+2 (vocabulaire obsolète)

📌 À faire (chantiers v10.1.0)

Migration AXIOM 2.1 :9110 (legacy actif)
Construction AGORA + migration des 6 connecteurs olympus-*
Brief autre chat (méthode AppForge sync vocabulaire)
Renommage dossier Cockpit/ → plus tard, non urgent