En 2026, une recherche sur un tutoriel d'installation OpenHuman renvoie encore vers d'anciens guides git clone + pip install -r requirements.txt. Ceux-ci décrivent des dépôts génériques de « digital human », pas l'agent de bureau tinyhumans distribué via des installeurs signés. Ce guide s'adresse aux débutants et aux développeurs qui veulent passer du téléchargement à la connexion, à l'intégration Gmail ou Slack, au premier cycle d'ingest d'environ vingt minutes, à un Memory Tree exploitable et, en option, à l'inférence locale Ollama sur macOS, Windows ou Linux. Nous commençons par six erreurs fréquentes, puis des tableaux d'environnement, des chemins d'installation signés, un runbook en huit étapes et une matrice de dépannage. Pour combiner OpenHuman avec OpenClaw sur du matériel dédié, consultez l'article jumeau sur la location Mac pour OpenClaw et OpenHuman. Les tarifs mensuels figurent sur la page tarifs NOVAKVM, la commande sur la page commander. Commandes et versions ci-dessous alignées sur la documentation officielle tinyhumans et GitHub Releases ; rouvrez ces liens après chaque release.
[ SECTION_01 ] // PAIN_MAP Six idées reçues lors de l'installation OpenHuman (2026)
- « Il faut d'abord git clone et pip install » : Le chemin principal est un installeur bureau ou un gestionnaire système (Homebrew, dépôt APT signé, MSI signé), pas un environnement Python monté à la main depuis un fork.
- « Sans GPU NVIDIA, ça ne démarre pas » : OpenHuman route par défaut vers un modèle hébergé ; les étapes sensibles peuvent optionnellement passer par Ollama sur CPU ou Apple Silicon. Un rack CUDA n'est pas requis.
- « Le Briefing doit être riche juste après l'install » : Getting Started indique qu'après connexion d'une source, le premier tirage automatique se déclenche en environ vingt minutes. Tester la mémoire avant cette fenêtre ressemble souvent à une panne.
- « Tout est dans le cloud » : La base Memory Tree, le vault Markdown et la config workspace restent en local. Connexion, une partie des OAuth et le routage modèle peuvent toucher des services hébergés — connaître la frontière.
- « curl | bash équivaut à Homebrew » : Le README signale que les scripts viennent de
raw.githubusercontent.comsans vérification de signature séparée. En production, privilégiez les paquets natifs signés. - « Un portable en veille suffit pour l'ingest prod » : Grosses boîtes mail et dépôts code consomment RAM et SSD ; fermer le capot interrompt la synchro. « L'app s'ouvre » et « l'ingest tourne 7j/7 » ne mesurent pas la même chose.
Points d'entrée officiels OpenHuman — à rouvrir après chaque release :
Page de téléchargement OpenHuman (tinyhumans.ai)
OpenHuman Getting Started (GitBook)
tinyhumansai/openhuman (dépôt GitHub et Releases)
[ SECTION_02 ] // ENV_MATRIX Prérequis OpenHuman : minimums et choix d'hébergement
Le tableau résume des planchers réalistes pour le client bureau. Avec Ollama sur la même machine ou une archive Gmail volumineuse, visez la colonne recommandée. Tarifs et stock sur la page tarifs.
| Élément | Minimum | Recommandé (grosse boîte mail + modèle local optionnel) |
|---|---|---|
| Système | macOS / Windows / Linux selon la page de téléchargement | macOS 14+ sur Apple Silicon ou Ubuntu 24.04 LTS bureau |
| Mémoire | Docs officiels : 4 Go+ | 16 Go+ ; très gros Gmail ou dépôt plus Ollama : 24–32 Go |
| Disque | Quelques Go libres | SSD rapide ; vault plus ingest SQLite croît avec la taille mail |
| GPU | Non requis (route hébergée) | Mémoire unifiée Apple Silicon pour inférence locale ; Ollama CPU possible |
| Réseau | Connexion et OAuth intégrations accessibles | Sortie stable ; premier ingest et cycles ~20 min exigent disponibilité |
| Hôte | Friction install | Ingest arrière-plan | Problème typique |
|---|---|---|---|
| MacBook personnel | Faible (Homebrew / DMG) | S'arrête capot fermé ; ok pour essai | Mail perso et mémoire agent sur un même disque |
| VPS Linux headless | Élevée (hors chemin officiel principal) | Pas de GUI native ni intégrations bureau | Contexte écran et voix limités |
| Mac mini M4 NOVAKVM mensuel | Faible (même chemin macOS) | Bare metal dédié en ligne 7j/7 | Prévoir sauvegarde vault et effacement avant retour |
Vous validez seulement l'UI et un prompt ? Un portable suffit. Pour faire tourner l'ingest Memory Tree des semaines, placez l'app sur un Mac de production qui ne dort jamais.
[ SECTION_03 ] // INSTALL Installer OpenHuman : paquets signés d'abord, scripts en secours
macOS (Homebrew recommandé — chaîne de signature du gestionnaire système) :
brew tap tinyhumansai/core
brew install openhumanLinux (dépôt APT signé Debian/Ubuntu — architecture selon repo officiel) : importer la clé GPG, ajouter l'entrée sources.list.d, puis apt-get install openhuman. Séquence complète dans le README GitHub « Linux (Debian/Ubuntu — signed apt repo) » ; revérifier les URL après release.
Windows : télécharger le .msi signé depuis GitHub Releases ou la page officielle et lancer l'installeur.
Installeurs universels : Releases fournit aussi .dmg, .deb et .AppImage. Des scripts macOS/Linux et Windows existent, mais le README les qualifie de scripts live sans signature d'intégrité séparée — risque plus élevé que les paquets natifs.
curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bashAprès installation, lancer l'app bureau une fois et confirmer l'icône OpenHuman dans le Dock ou le menu Démarrer. Ne sautez pas connexion et source de données à cette étape.
[ SECTION_04 ] // RUNBOOK Huit étapes vers un OpenHuman opérationnel : login, sources, premier prompt, IA locale
- Télécharger et installer : privilégier Homebrew, APT ou MSI ; lancer l'app et aligner le build sur la page Releases.
- Se connecter : premier écran Sign in ; la plupart utilisent la connexion sociale. Le panneau Advanced accepte une URL core RPC custom pour backend self-hosted — ignorer sinon.
- Comprendre local vs hébergé : Memory Tree, vault et workspace restent locaux ; connexion par défaut, routage modèle, OAuth intégrations et proxy recherche passent par services hébergés sauf Custom setup.
- Connecter au moins une source : assistant réglages pour OAuth Gmail, Slack, etc. En cas d'échec, vérifier l'horloge système et le callback navigateur.
- Attendre le premier cycle ingest : docs officielles : premier tirage automatique environ vingt minutes après connexion. L'UI fonctionne tout de suite ; les réponses type Briefing peuvent sembler vides.
- Envoyer un prompt de smoke test : après ingest, par ex. « résume les thèmes de mes mails de la semaine dernière » pour valider le contexte Memory Tree.
- Optionnel : activer Ollama IA locale : basculer le runtime local dans les réglages si disponible. Modèles co-localisés : 16 Go+ RAM ; surveiller la croissance SSD.
- Sauvegarder le répertoire vault : avant migration ou fin de location, copier SQLite Memory Tree et vault
.mdcompatible Obsidian — réinstaller l'app seule ne restaure pas la mémoire.
Memory Tree canonise les données connectées en blocs Markdown d'environ 3k tokens, stocke des résumés en couches dans SQLite local et reflète un vault éditable. Architecture différente des chats cloud qui repartent de zéro à chaque session. Pour ingest long sur Mac distant : baseline SSH et session dans le centre d'aide.
[ SECTION_05 ] // TROUBLESHOOT Erreurs d'installation et premier lancement OpenHuman
| Symptôme | Cause probable | Piste de correction |
|---|---|---|
| Tutoriel pip suivi, pas d'icône app | Mauvais template non-tinyhumans | Basculer vers install bureau tinyhumans et Releases |
| Connecté mais pas de contexte mail | Premier cycle ingest non terminé | Attendre ~20 minutes, retester le prompt |
| Disque qui grossit vite | Grosse boîte mail plus double écriture vault | Nettoyer anciennes connexions, SSD plus grand ou tier 512 Go+ |
| Saccades après activation Ollama | Taille modèle vs RAM disponible | Modèle quantifié plus petit ou passer à 24–32 Go RAM |
| brew install openhuman échoue | Tap manquant ou architecture non supportée | Vérifier brew tap et noms paquets Apple Silicon vs Intel dans README |
Avancé : smoke test de briefing contenu. Après ingest, demander à OpenHuman un script oral de 30 secondes à partir d'un fil mail. Éditer les blocs Markdown directement dans le vault. Participation Meet temps réel, lip-sync mascotte, etc. dépendent du Release courant — ne pas extrapoler depuis chaque démo marketing.
[ SECTION_06 ] // HARD_FACTS Faits techniques citables et conclusion NOVAKVM
- Licence et dépôt : OpenHuman est publié sur GitHub sous GNU GPL-3.0 à
tinyhumansai/openhuman. (Source : LICENSE ; revérifier après releases.) - Exigences système : Getting Started liste macOS, Windows et Linux bureau avec 4 Go+ RAM ; grosses boîtes mail, gros dépôts ou modèles locaux suggèrent 16 Go+.
- Architecture mémoire : Memory Tree+ canonise en blocs Markdown ≤3k tokens, résumés en couches SQLite, vault compatible Obsidian. (Source : section fonctionnalités README.)
- Timing intégrations : après connexion Gmail ou similaire, le premier tirage automatique se déclenche en environ vingt minutes ; cadence arrière-plan suivante selon GitBook.
- Vérité version : GitHub Releases et écran About in-app font foi ; ignorer comptes d'étoiles ou classements benchmark non cités.
Considérer « installé » comme terminé est prématuré. Un portable personnel convient pour un essai week-end, mais veille, mises à jour OS et mail perso sur le même disque coupent l'ingest Memory Tree en permanence. Un VPS Linux headless offre rarement les intégrations bureau mises en avant par OpenHuman. Si les essais locaux confirment l'intérêt, une voie prod pragmatique : louer un Mac mini M4 dédié deux à quatre semaines, observer croissance vault et stabilité ingest, puis décider d'acheter.
Choisissez mémoire et disque sur la page tarifs NOVAKVM, provisionnez un nœud depuis la page commander, suivez le runbook en huit étapes. Pour une prod OpenHuman exigeant le chemin install macOS natif, ingest grosse boîte mail 7j/7 et effacement prévisible avant retour, la location bare metal Mac mini NOVAKVM coûte en général moins qu'un portable laissé éveillé indéfiniment.