OpenHuman, développé par TinyHumans AI, est un agent personnel prioritairement desktop : connectez Gmail, calendriers et GitHub, puis consolidez le contexte dans un Memory Tree local et un vault Markdown compatible Obsidian sur SQLite. Ollama peut optionnellement router les charges de travail sur l'appareil. De nombreux résultats de recherche décrivent encore pip install et des checkpoints Python — ce n'est pas le chemin de distribution 2026.
Ce guide s'adresse aux débutants comme aux développeurs qui ont besoin d'une installation propre sur macOS, Windows ou Linux sans compiler Rust eux-mêmes. Vous y trouverez une liste de points de friction, une matrice d'hôtes, des installations par paquets signés et un parcours en six étapes du premier lancement aux intégrations, à Ollama et à la validation du Memory Tree. À la fin, vous saurez si votre répertoire de données doit rester sur un portable ou migrer vers un Mac mini toujours allumé.
01 Points de friction à l'installation OpenHuman : ce n'est pas le workflow git clone plus pip
OpenHuman est distribué comme application desktop Rust + Tauri + React (GPL-3.0, Early Beta). Contrairement à OpenClaw (Gateway terminal et plugins Node) ou à Hermes Agent (l'installateur dépose Python 3.11 et Node 22 sous ~/.hermes/), l'utilisateur final ne construit pas de venv Python. La contribution depuis les sources suit un parcours distinct avec Node 24+, pnpm et la chaîne Rust.
- Tutoriels obsolètes : Des articles génériques sur les « digital humans » mentionnent
condaetcheckpoints/*.pth; ces modèles ne correspondent pas àtinyhumansai/openhuman. - Installations scriptées sans contrôle d'intégrité : Le README avertit que
curl … | bashne détecte pas un script altéré ; privilégiez les bottles Homebrew, apt signé ou MSI. - Local et managé : Le Memory Tree et l'espace de travail restent sur disque, mais la connexion par défaut, le routage de modèles et certains flux OAuth passent par les services hébergés OpenHuman, sauf bascule vers des modèles BYO et le mode Composio direct.
- La veille interrompt la synchronisation : Des boucles auto-fetch d'environ vingt minutes exigent un hôte éveillé ; la mise en veille d'un portable stoppe l'ingestion de contexte.
- Linux Wayland : L'AppImage peut planter sur certains environnements Wayland ; les utilisateurs Debian et Ubuntu devraient préférer .deb / apt (voir l'issue upstream #2463).
Pour les équipes soumises au RGPD, le stockage local du Memory Tree, du vault et de SQLite sur un hôte dédié facilite la conformité par rapport aux assistants SaaS, à condition de maîtriser les droits d'accès, le chiffrement et un plan de suppression documenté en fin de contrat.
L'installation prend moins de vingt minutes ; la disponibilité et les sauvegardes du vault déterminent la valeur à long terme.
Les commandes suivent la documentation officielle TinyHumans ; rouvrez les liens après chaque release.
02 Exigences OpenHuman et matrice d'hôtes : où exécuter la production
Les artefacts officiels couvrent macOS (Intel et Apple Silicon), Windows 10/11 et Linux (Debian/Ubuntu amd64, Arch AUR). Le tableau ci-dessous sert à la sélection d'hôte ; RAM et disque doivent suivre la taille de votre modèle Ollama.
| Hôte | Disponibilité 24/7 | Friction d'installation | Memory Tree / Ollama | Limite typique |
|---|---|---|---|---|
| MacBook | La veille casse le sync | Faible (Homebrew / dmg) | Excellent sur Apple Silicon | Mises à jour OS, capot fermé |
| Bureau Windows | Peut rester allumé, redémarrages | Faible (MSI signé) | NVIDIA optionnelle | Pas d'outillage macOS natif |
| Bureau Linux | Élevée sur serveurs | Moyenne (apt plutôt qu'AppImage) | Ollama pris en charge | GUI headless à gérer |
| Location Mac mini M4 | SLA datacenter | Faible (SSH + brew) | Mémoire unifiée pour 7B–14B | Choisir région et durée |
Indications ressources avec Ollama : Modèles hébergés plus intégrations légères : environ 8 Go de RAM ; conserver un modèle 7B actif avec outils navigateur : 16 Go ou plus. Prévoyez 10–30 Go de SSD pour Memory Tree, vault et croissance SQLite. Sur Apple Silicon, Ollama s'appuie sur l'API Metal pour une inférence locale efficace.
Si vous synchronisez des e-mails, événements de calendrier ou issues GitHub contenant des données personnelles, définissez tôt où résident physiquement les fichiers SQLite et les chunks Markdown. Un Mac mini dédié avec suppression contractuelle des données réduit les risques RGPD par rapport à un portable partagé synchronisé dans le cloud.
03 Chemins d'installation officiels OpenHuman : Homebrew, apt et Releases
Ordre recommandé : téléchargement depuis le site ou GitHub Releases, ou gestionnaire de paquets OS avec signature. N'utilisez curl/bash que si les paquets sont indisponibles.
macOS (Homebrew, recommandé officiellement) :
brew tap tinyhumansai/core
brew install openhuman
openhuman --versionDebian et Ubuntu (dépôt apt signé) :
sudo apt-get install -y --no-install-recommends gnupg2 curl ca-certificates
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 openhumanWindows : installer le .msi signé depuis Releases.
Alternative (sans contrôle d'intégrité, à utiliser avec prudence) : installation scriptée selon le README ; vérifiez après chaque release si une vérification GPG est disponible (issue #2620).
04 Six étapes : premier lancement, intégrations, Ollama, contrôle Memory Tree
- Installer et lancer : ouvrir l'application depuis le lanceur OS ou exécuter
openhuman --versionsi le CLI est dans le PATH ; aligner le tag sur Releases. - Terminer l'onboarding : le mode managé par défaut requiert un compte OpenHuman pour le routage et OAuth ; les expériences locales utilisent BYO / Ollama selon la doc Local AI.
- Installer Ollama (optionnel) : tirer les modèles documentés pour OpenHuman (par ex. familles Qwen2.5 ou Gemma3 — vérifier sur gitbook), puis sélectionner le point de terminaison local dans le routage de modèles.
- Tester les intégrations : connecter d'abord GitHub ou le calendrier ; attendre un cycle auto-fetch (~20 minutes) et surveiller le Memory Tree pour de nouveaux chunks.
- Valider Memory Tree et vault : confirmer la croissance de SQLite et des fichiers
.md; si vide, corriger OAuth et le timing avant de réinstaller. - Planifier l'hébergement 24/7 : migrer vers un Mac mini sans veille (local ou bare metal CALMVPS) et archiver le workspace en tarball avant changement d'hôte.
Sur bare metal CALMVPS, choisissez un palier sur la page tarifs, connectez-vous en SSH, exécutez les mêmes commandes brew et archivez le répertoire de données OpenHuman avant tout changement d'hôte. Avant résiliation : exporter vault et SQLite pour respecter les obligations RGPD de suppression.
05 Spécifications citables, erreurs courantes et conclusion CALMVPS
- Stack : coque Rust + Tauri v2 + React ; Memory Tree utilise SQLite local avec chunks Markdown (README / gitbook officiels).
- Cadence de sync : les intégrations actives tirent sur une boucle d'environ 20 minutes (pas de push temps réel).
- TokenJuice : les payloads outils et scrape se compressent avant les appels LLM ; la doc cite jusqu'à ~80 % de réduction de tokens selon la charge — mesurez vos propres factures.
| Symptôme | Cause probable | Correctif |
|---|---|---|
| Guide pip/conda échoue | Mauvaise documentation projet | Utiliser Homebrew, apt ou installateurs Release |
| Crash AppImage sous Linux | Wayland / sharun | Utiliser .deb ou contournements documentés |
| Ollama silencieux | Daemon ou modèle absent | ollama serve et ollama pull |
| Memory Tree vide | OAuth ou fenêtre fetch | Ré-authentifier et attendre un cycle fetch |
FAQ : pas de GPU dédiée requise — le chemin modèles hébergés n'impose pas de GPU ; Ollama local sur Apple Silicon avec Metal est généralement plus fluide qu'un Windows CPU seul. Série M : privilégier installateur arm64 et modèles Ollama arm64. Téléchargements lents : réseau miroir ou ollama pull préalable sur le Mac datacenter.
Un portable en veille casse la continuité auto-fetch ; un VPS offshore bon marché manque l'expérience desktop officielle ; sans sauvegardes, le contexte se perd à la migration. Pour des installations signées, Ollama sur Apple Silicon, sync mémoire vingt minutes et montées RAM rapides, la location bare metal Mac mini M4 CALMVPS reste le défaut production le plus solide — données locales sur Apple Silicon dédié, suppression RGPD planifiable contractuellement. Détails sur la page tarifs.