Installer OpenHuman sans savoir quoi vérifier quand ça coince, c'est bloquer au hasard. Ce guide suit le parcours officiel : à chaque étape, un critère de succès et un si ça bloque, vérifiez d'abord.
0 Vue d'ensemble : sept étapes de zéro au premier succès
En cas de blocage, situez-vous d'abord : téléchargement → installation → connexion → modèle → intégration → mémoire → première sortie. Le tableau ci-dessous sert de fil conducteur ; chaque section le détaille.
| Étape | Signe de succès | Blocage fréquent | Suite |
|---|---|---|---|
| Préparation | Site officiel accessible, RAM suffisante | Réseau/DNS, RAM insuffisante | Changer de réseau ou augmenter la RAM avant d'installer |
| Téléchargement / install | App lancée, version = site officiel | Mauvais projet, architecture incompatible | Vérifier domaine et Release |
| Connexion | Interface principale visible | Échec redirection OAuth | Autre navigateur, désactiver bloqueurs |
| Modèle | « Bonjour » obtient une réponse | BYOK / modèle local muet | Route par défaut d'abord, puis local |
| Intégration | Source affichée « connectée » | OAuth expiré, périmètre trop étroit | Réautoriser et revoir la portée |
| Mémoire | Entrées dans Memory | Arbre vide, moins de 20 min d'attente | Attendre le premier auto-fetch |
| Test réel | Résumé / tâches alignés sur les données | Sans contexte, hors sujet | Séparer « modèle » et « mémoire » |
1 Avant l'installation : système, réseau, comptes et données de test
D'après le Getting Started : bureau macOS / Windows / Linux, 4 Go+ RAM ; gros ingest ou modèle local sur la même machine → 16 Go+.
- Réseau — Accès à tinyhumans.ai/openhuman et à la doc GitBook ; le schéma par défaut passe par connexion et routage de modèles hébergés (pas un mode 100 % hors ligne).
- Comptes — Google/GitHub pour se connecter ; chaque intégration tierce exige un OAuth distinct : se connecter ≠ Gmail déjà branché.
- Données de test — Commencez par une boîte mail peu sensible ou un compte GitHub jetable pour valider l'écriture en mémoire ; évitez la boîte pro complète le premier jour.
- Modèle local (option) — Si vous visez Ollama, validez d'abord
ollama runen terminal, puis activez Local AI dans OpenHuman.
2 Source de téléchargement : éviter le mauvais projet ou la mauvaise version
Signe de succès : paquet depuis tinyhumans.ai/openhuman ou un gestionnaire listé par l'officiel ; numéro de version = dernière Release GitHub.
Voies recommandées (doc officielle, au choix) :
- Installateur site — DMG macOS, MSI/EXE Windows, AppImage ou .deb Linux (le plus simple pour débuter).
- Homebrew —
brew install tinyhumansai/openhuman/openhuman - Script — macOS/Linux :
curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash; PowerShell Windows : voir README.
tinyhumansai/openhuman, bundle « crack » tiers. En cas de doute : site + org GitHub officielle uniquement.3 Installation par plateforme : Mac, Windows, Linux
| Plateforme | Validation | Si ça bloque |
|---|---|---|
| macOS | DMG → Applications, app ouverte ; Gatekeeper → « Ouvrir » | Blocage sécurité → Réglages → Confidentialité et sécurité |
| Windows | MSI/EXE terminé, OpenHuman dans le menu Démarrer | SmartScreen → éditeur ; runtime VC++ manquant |
| Linux | AppImage exécutable ou apt OK | Architecture amd64/arm64 vs machine |
Sur macOS, des permissions Accessibilité / saisie peuvent s'afficher — Settings → Automation & Channels ; refusez l'inutile pour le premier run.
4 Premier lancement : connexion, espace de travail, app qui ne s'ouvre pas
Écran d'accueil « Sign in! Let's Cook », connexion sociale ; l'URL RPC core personnalisée (Advanced) peut être ignorée par la plupart des utilisateurs.
Signe de succès : interface principale, chat et Settings visibles.Si ça bloque : OAuth bloqué par une extension → Safari/Edge en navigation privée ; écran blanc après login → quitter complètement l'app et consulter logs/diagnostic dans Settings (selon la version).
5 Modèles : routage par défaut, BYOK et local silencieux
OpenHuman choisit le modèle selon la tâche (Automatic Model Routing). Conseil débutant : valider d'abord la route cloud, puis activer Local AI.
Signe de succès : « Bonjour » ou « Présente-toi en une phrase » obtient une réponse cohérente.Si ça bloque :
- Aucune réponse — réseau/proxy ; fenêtre de maintenance Early Beta (Discord / Issues GitHub).
- BYOK en échec — clé complète, provider aligné avec les réglages, solde du compte.
- Ollama / LM Studio muet — service local joignable en terminal ; puis Local AI dans Settings et
local_ai.runtime_enabled(GitBook Configuration).
6 Intégrations : OAuth, périmètre de sync et rafraîchissement
Dans Settings, reliez Gmail, GitHub, calendrier, etc.Signe de succès : statut « connecté », sans erreur persistante.
Si ça bloque : connecté mais vide → périmètre OAuth lecture ; Google Workspace → approbation admin ; pas de refresh → attendre le premier auto-fetch (~20 minutes, doc officielle), pas de réinstall en boucle après quelques minutes.
7 Mémoire : contexte vide et validation
La mémoire vit en local dans le Memory Tree (SQLite + Markdown ; Memory → View vault in Obsidian pour /wiki/).
Signe de succès : après Gmail etc., nouvelles entrées Memory sous ~20 min ; « Qu'ai-je manqué ces 12 dernières heures ? » cite de vrais sujets de mail.
Si ça bloque : toujours vide → OAuth réellement OK ? compte test sans mails ? premier cycle terminé ? résumé absurde → contrôler les entrées brutes dans Obsidian : hallucination du modèle vs données jamais ingérées.
8 Premier test réel : une tâche pour tout valider
Prompts suggérés (style officiel) : « Summarize what I missed today. » ou en français : « D'après mes sources connectées, liste mes trois priorités du jour. »
Critères : ① réponse du modèle ; ② faits vérifiables dans Memory/Obsidian ; ③ question plus précise (nom de projet) encore pertinente. Échec ② seul → mémoire ; ① seul → modèle ; les deux → connexion et réseau.
9 Clôture : quand réinstaller, comment garder la config
Doc / Issues avant réinstall : un OAuth, une intégration ou Ollama local ne justifient en général pas une réinstall complète. Réinstall utile : paquet corrompu, gros saut de version propre, ou consigne explicite dans les Release notes.
Conserver la config : Memory Tree et vault Markdown restent sur le disque — notez le chemin dans Memory et sauvegardez le dossier avant toute réinstall (ne supprimez pas de chemins inconnus). Désinstallation : brew uninstall openhuman ; apt remove ; install manuelle curl → docs/install.md sur GitHub.
Sans solution → Issues GitHub, Release notes ou Discord (discord.tinyhumans.ai) avec version et étapes de reproduction.
Cochez ces points pour confirmer qu'OpenHuman est opérationnel et dépannable sur votre machine :
- 1Installation canal officiel, version = Release
- 2Connexion OK, chat sur l'interface principale
- 3Routage modèle par défaut répond à « Bonjour »
- 4Au moins une intégration peu sensible en OAuth réussi
- 5Entrées Memory, vault Obsidian accessible
- 6Premier résumé / tâches alignés sur les données
- 7Vous savez quelle étape viser et où lire la doc officielle
10 OpenHuman plus stable sur Mac mini
OpenHuman combine auto-fetch, SQLite et Ollama optionnel — le Mac mini M4 (mémoire unifiée, ~4 W au repos) convient à un nœud 7×24 ; macOS simplifie Homebrew, permissions et Obsidian. Validez ce guide localement, puis envisagez un mini dédié pour isoler votre Memory Tree du Mac de travail.
OpenHuman 24/7 · mémoire localeObtenir un Mac mini pour votre nœud OpenHuman
Faible consommation en continu · mémoire unifiée pour Ollama · isolé du Mac principal, idéal pour tester la mémoire IA personnelle.