● Golden Build · Installation modulaire

Installer Jarvis, un module à la fois.

Ce guide part d’un Ubuntu minimal déjà installé. Il ne lance jamais l’installation complète automatiquement : chaque module est exécuté, contrôlé et validé avant de passer au suivant. Le but est de toujours savoir ce qui a été installé, pourquoi, et comment vérifier que cela fonctionne.

Lire le mode d’emploi ↓Voir les modules← Présentation

Mode d’emploi détaillé

Cette documentation est conçue pour être utilisée pendant une vraie installation. Il est recommandé de garder cette page ouverte sur une seconde machine ou un téléphone pendant que vous travaillez sur Jarvis.

Avant de commencer

  1. Installer une version Ubuntu 26.04.x LTS minimale et vérifier que la machine démarre normalement.
  2. Prévoir un compte capable d’utiliser sudo. Si le compte final n’existe pas encore, le Module 00 explique comment le créer.
  3. Vérifier qu’une connexion Internet est disponible pour les modules qui téléchargent des logiciels.
  4. Garder vos informations privées dans une fiche séparée : adresses réseau, utilisateurs, mots de passe, clés et tokens.
  5. Ne jamais ajouter ces valeurs privées dans les fichiers HTML publics.

Règle des placeholders

Lorsqu’une commande contient un texte en majuscules comme METTRE_VOTRE_USER, vous devez remplacer ce texte localement avant d’exécuter la commande. Le site ne doit jamais être modifié pour y inscrire votre secret réel.

Adresse réseauMETTRE_VOTRE_IP
UtilisateurMETTRE_VOTRE_USER
HostnameMETTRE_VOTRE_HOSTNAME
Clé APIMETTRE_VOTRE_CLE_API
Mot de passeMETTRE_VOTRE_PASSWORD
TokenMETTRE_VOTRE_TOKEN
Chemin spécifiqueMETTRE_VOTRE_CHEMIN
Fuseau horaireMETTRE_VOTRE_TIMEZONE
1. PréparerLire l’objectif et vérifier tous les prérequis avant d’exécuter une commande.
2. ExécuterCopier une seule commande à la fois. Remplacer les placeholders uniquement dans votre terminal.
3. ContrôlerComparer la sortie avec le résultat attendu et effectuer les tests de validation.
4. ValiderCocher la checklist STOP. Ne passer au module suivant que lorsque tout est conforme.

Une commande à la fois

Évitez de coller un chapitre complet. Si une commande échoue, arrêtez-vous à cette étape afin que le diagnostic reste simple.

Lire avant de modifier

Les modules commencent autant que possible par des commandes de lecture seule. Elles permettent de connaître l’état réel avant de changer la configuration.

Ne pas masquer une erreur

Le module suivant ne doit jamais servir à contourner une erreur du module courant. Corrigez le problème avant de continuer.

Sauvegarder avant un fichier critique

Quand un module modifie un fichier système important, une copie de sécurité est faite avant modification lorsque cela est pertinent.

Après un redémarrage

Reconnectez-vous avec le compte prévu, revenez exactement à l’étape suivante du même module et relancez ses contrôles.

En cas d’écart

Conservez la sortie exacte de la commande en erreur. C’est cette sortie qui permettra de diagnostiquer le problème sans deviner.

Exemple : si la documentation affiche ssh METTRE_VOTRE_USER@METTRE_VOTRE_IP, la valeur réelle est utilisée uniquement dans votre terminal. Elle ne doit pas être enregistrée dans cette page Web.
Important : aucune commande contenant encore un placeholder ne doit être exécutée telle quelle. Vérifiez toujours visuellement la ligne avant d’appuyer sur Entrée.

Comment lire une page module

Chaque page utilise la même légende. Elle permet de voir immédiatement si une commande observe le système ou le modifie.

Lecture seuleModificationValidationOptionnel

Structure standard

  1. Objectif du module.
  2. Prérequis et état de départ.
  3. Commandes expliquées une par une.
  4. Résultat attendu après les étapes importantes.
  5. Contrôles et diagnostic de base.
  6. Checklist STOP de fin de module.

Quand demander de l’aide

Si un résultat diffère de celui annoncé, arrêtez le module et conservez : la commande exécutée, sa sortie complète et le numéro de l’étape. Cela permet de reprendre exactement au bon endroit.

Ordre d’installation

L’ordre respecte les dépendances du Golden Build. Le parcours principal contient désormais 17 modules obligatoires, numérotés de 00 à 16. Les intégrations personnelles et environnementales sont regroupées en options après la validation finale.

00

Préparation Ubuntu

Préparer Ubuntu minimal, les outils de base, le compte, le réseau et les prérequis système.

SystèmeOrdre 1/17Disponible →
01

Stockage Golden / NAS

Préparer l’accès au stockage Golden et le montage NFS persistant.

SystèmeOrdre 2/17Disponible →
02

Docker Engine

Installer Docker depuis le dépôt officiel et valider l’exécution de conteneurs.

SystèmeOrdre 3/17Disponible →
03

Ollama / ROCm

Installer Ollama et valider le backend GPU AMD ROCm.

IA localeOrdre 4/17Disponible →
04

Modèle local

Installer Qwen Golden ou choisir une alternative adaptée à la mémoire UMA.

IA localeOrdre 5/17Disponible →
05

Hermes Agent

Installer Hermes et connecter l’agent au modèle local.

HermesOrdre 6/17Disponible →
06

Hermes API / Gateway

Mettre en service la Gateway et l’API locale Hermes.

HermesOrdre 7/17Disponible →
08

Skills Golden

Restaurer puis vérifier les skills personnalisés de Jarvis.

HermesOrdre 9/17Disponible →
09

Telegram

Créer un bot privé, sécuriser son token, limiter les utilisateurs et valider les échanges texte.

InterfacesDisponible
10

Voix locale

Installer et vérifier la transcription et la synthèse vocale locales.

InterfacesDisponible
11

Camofox + recherche Web

Installer le navigateur local persistant et le fallback de recherche Web.

RechercheDisponible
12

Open WebUI

Installer l’interface Web privée, persister ses données et la connecter à Hermes.

InterfacesDisponible
13

Scripts Jarvis

Restaurer les scripts de diagnostic, d’inventaire et le bootstrap Golden.

ExploitationDisponible
15

Watchdog

Activer la supervision périodique et les alertes Telegram uniquement sur changement d’état.

ExploitationDisponible
16

Validation finale

Exécuter la checklist complète du Golden Build, tester le reboot et valider le cœur de Jarvis.

ValidationDisponible
Parcours principal complet : les Modules 00 à 16 sont maintenant documentés. Une fois le Module 16 validé, vous pouvez ajouter les options selon vos besoins.

Options — Après validation finale, place aux prompts

Ces options ne sont pas nécessaires pour valider le cœur de Jarvis/Hermes. Après le Module 16, la méthode change : chaque extension est pilotée par un prompt Hermes contraint, avec validation et confirmation humaine pour les actions sensibles.

Nouvelle phase : le socle étant désormais validé, Hermes peut devenir l’installateur guidé des options. Commencez par l’Option 01 pour disposer d’un modèle de prompt générique adaptable. Ouvrir la page Options →
01

Prompt générique adaptable

Un modèle universel à personnaliser pour déléguer proprement une nouvelle intégration à Hermes après validation finale.

Prompt HermesDisponible
02

Gmail / Himalaya

Configurer Gmail directement depuis Hermes avec un prompt guidé, Himalaya et des secrets protégés.

Prompt HermesDisponible
03

Google Calendar / iCal

Configurer depuis Hermes une consultation strictement read-only de Google Calendar via l’adresse iCal secrète.

Prompt HermesDisponible
04

UniFi

Connecter Hermes à l’infrastructure UniFi via l’API officielle avec un helper strictement GET-only.

RéseauDisponible
05

Home Assistant

Connecter Hermes à Home Assistant pour consulter les états et piloter la domotique avec confirmation sur les actions sensibles.

DomotiqueDisponible