2026 OpenHuman : guide d'installation — Memory Tree, brew/apt/npm et location Mac cloud

OpenHuman, édité par TinyHumans AI, est un assistant agentique de bureau sous licence GPL-3.0. L'interface Tauri, le mode mascotte bureau, la pipeline voix native et le Memory Tree le distinguent des gateways CLI comme Hermes ou des stacks orientés canaux comme OpenClaw. Le Memory Tree canonicalise les sources connectées en chunks Markdown d'environ trois mille tokens maximum, les score, les plie en arbres de résumé hiérarchiques et stocke le tout dans SQLite sur votre machine. Les mêmes chunks deviennent des fichiers .md dans un vault compatible Obsidian — local-first, chiffré, sous votre contrôle.

Réussir l'installation n'est que la première porte. Les utilisateurs connectent Gmail, Notion ou Slack et attendent que l'assistant connaisse déjà le contexte calendrier le matin sans reprompting. Cela suppose un hôte où les boucles auto-fetch, les fichiers SQLite et les répertoires vault survivent aux reboots et mises à jour système. Un MacBook de développement convient pour les étapes ci-dessous ; y faire tourner OpenHuman en production sur un portable qui dort ne convient pas. Les équipes qui construisent un Memory Tree sur des semaines migrent souvent vers un Mac cloud dédié une fois le pilote prouvé.

OpenHuman utilise par défaut des services managés pour la connexion, le routage de modèles et OAuth Composio. Vous pouvez opérer avec vos propres modèles, Ollama en loopback ou le mode Composio direct — documenté en amont. Choisissez avant l'installation si vous partez cloud-API-first ou local-AI-first afin de positionner local_ai correctement en une session.

La plupart des tickets OpenHuman ne viennent pas d'installateurs cassés. Ils viennent d'hôtes inadaptés, de RAM insuffisante pour des jobs auto-fetch parallèles ou de fichiers Memory Tree sur volumes éphémères. Le tableau aligne les attentes par plateforme avec ce dont OpenHuman a besoin pour un Memory Tree qui grandit en continu.

• Planification RAM : Usage léger avec routage cloud et peu d'intégrations tourne sur 4 Go RAM. Memory Tree avec auto-fetch, compression TokenJuice et Ollama 7B/8B optionnel profite de 16 Go RAM ou plus. Un 13B parallèle plus GUI bureau sur un nœud partagé exige 24 Go ou une séparation temporelle avec OpenClaw.
• Node pour les sources : Les contributeurs ont besoin de Node.js 24+, pnpm 10.10.0, Rust 1.93.0 et prérequis build bureau. Les installs production doivent préférer les paquets natifs (brew/apt), pas des builds npm à chaque reboot.
• Utilisateur Unix dédié : Exécutez OpenHuman sous un compte non root avec home fixe. Mélanger SQLite Memory Tree et vault avec root ou logins partagés complique backup et permissions OAuth.
• Disposition disque : Prévoyez de l'espace séparé pour SQLite mémoire, vault Obsidian et logs. Un volume racine de 15 Go se remplit vite une fois auto-fetch ingère des chunks Gmail et Notion pendant des semaines.
• Note GPL-3.0 : OpenHuman est sous GPL-3.0. Les pilotes internes sur nœud loué sont courants ; vérifiez la conformité si vous redistribuez ou exposez le binaire — contrairement au MIT pour Hermes ou OpenClaw.

Après installation, vérifiez que l'assistant démarre et que le chemin config repose sur disque persistant avant de brancher dix intégrations OAuth. Corriger la dérive d'environnement en amont évite des heures de restauration SQLite.

L'amont recommande des chemins paquets natifs avec chaîne de signature OS. Le script curl est alternatif mais sans vérification d'intégrité séparée. Sur un Mac cloud NUKCLOUD en SSH, suivez ces six étapes dans l'ordre.

1. 01
   Préparer l'hôte : Sur macOS, confirmez les Xcode Command Line Tools. Sur Ubuntu, sudo apt-get install -y gnupg2 curl ca-certificates. Créez un utilisateur dédié comme openhuman avec home sur disque persistant.
2. 02
   Choisir le chemin préféré : macOS via tap Homebrew, Linux via dépôt apt signé, ou pour développeurs npm/pnpm depuis clone. Production : brew ou apt, pas npm nightly.
3. 03
   Vérifier le binaire : Lancer l'app sous macOS ou openhuman --version si CLI disponible. Attention PATH et invites Gatekeeper pour artefacts non signés.
4. 04
   Première GUI via VNC : Sur Mac cloud, connecter VNC, parcourir le wizard d'onboarding, choisir compte ou mode local.
5. 05
   Noter le répertoire config : Chemin vers config.toml et store Memory Tree depuis wizard ou doc — base pour sauvegardes.
6. 06
   Snapshot baseline : Version mineure macOS, tarball de l'arborescence config avant OAuth et auto-fetch.

brew tap tinyhumansai/core
brew install openhuman

curl -fsSL https://tinyhumansai.github.io/openhuman/apt/KEY.gpg \
  | sudo gpg --dearmor -o /etc/apt/keyrings/openhuman.gpg
echo "deb [signed-by=/etc/apt/keyrings/openhuman.gpg arch=amd64] \
  https://tinyhumansai.github.io/openhuman/apt stable main" \
  | sudo tee /etc/apt/sources.list.d/openhuman.list
sudo apt-get update
sudo apt-get install -y openhuman

curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash

git clone https://github.com/tinyhumansai/openhuman.git
cd openhuman
git submodule update --init --recursive
pnpm install
pnpm --filter openhuman-app dev:app

Choisissez SKU et RAM avant install sur la page tarifs, ouvrez l'instance via Commander. Pour production 16 Go avec Memory Tree plus Ollama 8B, la SKU baseline suffit ; 13B parallèle à OpenClaw exige un upsizing avant le premier ollama pull.

L'IA locale est désactivée par défaut. Activez-la explicitement dans config.toml (chemin selon wizard ou doc) quand Ollama tourne sur le même hôte — typique sur Mac Mini M4 loué avec inférence loopback.

local_ai.runtime_enabled = true
local_ai.opt_in_confirmed = true

Endpoint Ollama : Dans les réglages, définir http://127.0.0.1:11434, choisir un tag modèle adapté à la RAM — 7B/8B sur 16 Go, tags plus lourds seulement avec plus de mémoire unifiée. OLLAMA_KEEP_ALIVE=-1 évite la latence cold-start lors des bursts auto-fetch.

Memory Tree : L'arbre grandit avec chaque intégration et chaque cycle auto-fetch de vingt minutes. SQLite et répertoire vault doivent résider sur le même volume persistant. Optionnellement memory.backend = "agentmemory" pour brancher un store agentmemory externe — utile si vous partagez déjà agentmemory avec d'autres agents de code.

Test fumée : Connecter une intégration, attendre un cycle sync, puis poser en nouvelle session une question sur un fait qui ne peut venir que de cette intégration. Si le rappel échoue après reboot contrôlé, corrigez persistance disque et chemin config avant d'ajouter d'autres flux OAuth.

Après édition de config.toml, redémarrez l'assistant et vérifiez que la compression TokenJuice apparaît dans les logs — signal que la sortie outil est compressée avant l'appel LLM.

OpenHuman est UI-first. SSH seul ne suffit pas pour la configuration initiale sur Mac cloud headless — VNC ou partage d'écran est requis pour le wizard, les flux OAuth navigateur et le test mascotte.

Flux VNC : Ouvrir VNC depuis le panel provider, lancer OpenHuman, connecter Gmail / Notion / Slack, définir l'endpoint Ollama dans les réglages. Restreindre VNC au VPN ou allowlist IP ; les tokens OAuth sont chiffrés localement, mais l'écran montre du contenu sensible.

Ollama d'abord : Avant local_ai OpenHuman, brew install ollama, pull modèles, valider ollama serve avec curl localhost:11434/api/tags. Reprenez l'ordre du guide OpenClaw OpenHuman si les deux stacks partagent un nœud.

Persistance macOS : Enregistrer OpenHuman comme élément de connexion ou LaunchAgent pour que auto-fetch reprenne après reboot. WorkingDirectory sur le home de l'utilisateur dédié. Après reboot, check VNC : taille Memory Tree et horodatage dernier sync doivent rester cohérents.

Rythme backup : Tarballs hebdomadaires du répertoire config, SQLite mémoire et vault vers object storage chiffré. Pendant le pilote, pas de snapshots disque sans backup — un snapshot reverti efface des semaines de Memory Tree sans avertissement.

Pour les gateways Telegram parallèles, suivez le guide installation Hermes sur utilisateur ou hôte séparé pour éviter conflits RAM avec Ollama. Questions d'exploitation : page aide.

OpenHuman exige bureau macOS et stockage SQLite persistant — les VPS Linux couvrent install apt mais ne remplacent pas l'expérience Tauri. Les Mac Mini maison fonctionnent avec discipline alimentation et VNC ; les équipes entreprise louent un Mac cloud quand le Memory Tree doit grandir sur des mois sans baby-sitting portable.

Les stacks hybrides sont courantes : Hermes ou OpenClaw vers l'extérieur, OpenHuman dedans pour mémoire bureau. Comptes Unix séparés, modèles Ollama budgétés selon RAM, licences GPL et MIT séparées dans docs conformité. Après pilote réussi, scalez RAM via Commander sans revérifier OAuth si chemins vault stables.