macOS Homebrew · Memory Tree · 118+ OAuth · matrice d'erreurs · checklist VNC Mac distant
OpenHuman de tinyhumansai est un agent IA personnel desktop open source — pas une fenêtre de chat de plus, mais une couche d'intelligence locale qui combine mémoire, outils, intégrations et voix. La version stable v0.56.0 (2026-05-27) dépasse 30 000 étoiles GitHub. Ce guide couvre le parcours Homebrew macOS recommandé, la configuration LLM au premier lancement, le Memory Tree, 118+ connecteurs OAuth, une matrice d'erreurs en 10 lignes et une checklist d'acceptation VNC de 20 minutes. Il complète notre guide de déploiement OpenClaw & OpenHuman et le tutoriel d'installation Hermes Agent.
OpenHuman se présente comme une « Personal AI super intelligence » — privée, simple et extensible. Contrairement à OpenClaw ou Hermes Agent (tous deux terminal-first, modèle apporté par l'utilisateur), OpenHuman est GUI-first : une mascotte desktop réagit au contexte et continue en arrière-plan même quand vous arrêtez de taper.
La stack est Rust + Tauri + React, sous licence GNU GPL-3.0. Le projet reste en Early Beta — consultez les release notes avant de mettre à jour. Voici comment il se compare aux outils voisins :
| Dimension | OpenHuman | OpenClaw | Hermes Agent | Claude Cowork |
|---|---|---|---|---|
| Open source | GPL-3.0 | MIT | MIT | Propriétaire |
| Prise en main | GUI desktop, minutes | Terminal-first | Terminal-first | Desktop + CLI |
| Mémoire | Memory Tree + Obsidian | Dépend des plugins | Auto-apprentissage trois couches | Session |
| Intégrations | 118+ OAuth | BYO | BYO | Peu de connecteurs |
| Sync auto | ~20 min vers la mémoire | Aucune | Aucune | Aucune |
| Routage modèle | Intégré + TokenJuice | Manuel | Manuel | Modèle unique |
Si vous voulez une IA qui voit vraiment votre flux de travail quotidien sans vivre dans un terminal, les connecteurs et le Memory Tree d'OpenHuman font la différence. Comme il dépend du bureau graphique, les sessions SSH seules échouent aux permissions initiales et à OAuth — c'est là qu'un Mac loué avec VNC aide.
Côté conformité RGPD, le stockage local sous ~/.openhuman/memory/ intéresse les équipes françaises : les données des connecteurs sont vectorisées localement. Les appels API vers le LLM choisi restent toutefois à documenter dans votre registre de traitement.
Pour les installations binaires, macOS 12 Monterey ou plus récent suffit (14+ recommandé). Pour les builds source, le niveau d'exigence monte nettement :
| Dépendance | Utilisateur binaire | Build développeur |
|---|---|---|
| macOS | 12+ (14+ recommandé) | Idem |
| Node.js | Non requis | 24+ |
| pnpm | Non requis | 10.10.0 |
| Rust | Non requis | 1.93.0 via rustup |
| CMake / Xcode CLT | Peut être déclenché par Homebrew | Requis |
| GPU / CUDA | Non requis | Non requis |
L'inférence passe par votre fournisseur LLM (API ou Ollama local) ; l'app utilise WebKit via Tauri, pas d'entraînement GPU local. 8 Go de RAM suffisent pour un usage léger ; avec Memory Tree activé, 16 Go+ réduisent la pression swap. Disque : ~150–200 Mo pour l'app ; Memory Tree peut atteindre 2–5 Go ; les modèles Ollama s'ajoutent par modèle.
Sur Apple Silicon M1–M4, l'interface est fluide. Sur Intel, le premier build source prend plus de temps. Pour OpenHuman + Ollama sur Mac Mini M4 loué : Memory Tree + petit modèle 7B tient en 16 Go ; les modèles plus lourds demandent 24 Go ou des API cloud uniquement.
Options officielles : tap Homebrew (chaîne de packages signée), .dmg du site, script curl (déconseillé), ou compilation source. Suivez ces sept étapes pour Homebrew :
Installer Homebrew si absent : brew --version. L'installateur Homebrew peut déclencher Xcode Command Line Tools — cliquer Installer dans le GUI. SSH ne peut pas répondre à ce dialogue.
Ajouter le tap et installer :
brew tap tinyhumansai/core brew install openhuman
OpenHuman.app arrive dans ~/Applications. Le premier tap récupère les Formulas GitHub ; brew install télécharge le binaire précompilé et vérifie la somme.
Premier lancement & permissions : Ouvrir via Spotlight. Accorder Accessibilité et Notifications dans Confidentialité et sécurité — uniquement en session graphique.
Onboarding / LLM : Choisir Claude, OpenAI, Gemini, Grok ou Ollama ; saisir clés API ou TokenJuice. Privilégier les modèles long contexte pour Memory Tree.
Intégrations OAuth : Réglages → Integrations. Chaque connecteur ouvre un flux OAuth navigateur — navigateur par défaut du bureau requis.
Activer Memory Tree : Réglages → Memory → Enable. La première sync prend 10–25 minutes ; ne pas forcer la fermeture.
Test de fumée : Poser une question que seuls vos connecteurs connaissent, ex. « De quoi ai-je parlé par e-mail hier ? » si Gmail est lié.
Après installation, brew upgrade openhuman pour les mises à jour — en Early Beta, lisez les release notes GitHub avant de mettre à jour en production.
arm64 (Apple Silicon) ou x86_64 depuis tinyhumans.ai/openhuman ou GitHub Releases. Si Gatekeeper bloque : Confidentialité et sécurité → Ouvrir quand même.
curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash
La doc officielle avertit : pas de signature indépendante du script. Télécharger dans un fichier, relire, puis exécuter.
git clone https://github.com/tinyhumansai/openhuman.git cd openhuman git submodule update --init --recursive pnpm install pnpm --filter openhuman-app dev:app
Premier build natif sur M4 Pro : souvent 3–5 minutes ; plus lent sur Intel ancien. Les contributeurs testent les patches en source ; les utilisateurs finaux restent sur Homebrew.
Memory Tree est la fonction phare d'OpenHuman : un graphe de connaissances personnel cross-sources qui ingère résumés d'e-mails, PR, docs et événements calendrier, rafraîchi environ toutes les 20 minutes.
Sous Réglages → Memory, ajustez l'intervalle de sync (minimum 5 minutes) et le périmètre (ex. Gmail 90 derniers jours seulement). Pour un vault Obsidian, ajoutez la racine sous Local Sources — les changements Markdown sont indexés en lecture seule sauf si Obsidian Write est activé.
Excluez les données sensibles via filtres connecteur ou répertoires .private/. La base locale vit dans ~/.openhuman/memory/ — sauvegardez avant migration. Sur Mac loué : exportez ou effacez avant restitution du nœud selon le contrat.
Astuce support : la première sync échoue souvent si le Mac dort. Sur Mac distant, lancez caffeinate -dims pendant la sync ou désactivez la veille jusqu'à la coche verte.
| # | Symptôme | Cause probable | Correctif |
|---|---|---|---|
| 1 | brew tap 404 | Tap obsolète / réseau | brew update ; utiliser .dmg |
| 2 | Processus WebKit terminé | macOS ancien / cache corrompu | macOS 12+ ; vider ~/Library/WebKit/tinyhumansai |
| 3 | Invite Accessibilité clignote | TCC non enregistré | Ajouter OpenHuman manuellement dans Confidentialité |
| 4 | Callback OAuth échoue | Ports 58080–58090 occupés / mauvais navigateur | Libérer ports ; Safari/Chrome par défaut |
| 5 | Memory Tree bloqué à 0 % | Token expiré / réseau | Ré-autoriser le connecteur |
| 6 | Réponse LLM vide | Clé API / quota | Réglages → LLM → Test Connection |
| 7 | Auto-update échoue | Install non-Homebrew / droits | brew upgrade openhuman |
| 8 | Mascotte absente | Échelle affichage / Accessibilité | Échelle par défaut ; re-accorder Accessibilité |
| 9 | Obsidian watch idle | Espaces dans le chemin / Full Disk Access | Quoter le chemin ; accorder Full Disk Access |
| 10 | Pas de micro / voix | Permission micro | Confidentialité → Micro → OpenHuman |
Logs : ~/Library/Logs/tinyhumansai/. Cherchez les régressions sur GitHub Issues pour votre version exacte. En VNC : vérifiez que le bureau distant est bien au premier plan — certains dialogues TCC n'apparaissent que sur l'écran physique du Mac loué si le partage d'écran est mal configuré.
Ces étapes exigent une session graphique et échouent en SSH seul :
Se connecter en VNC (1440×900+). Confirmer que le bureau est visible.
Lancer brew tap tinyhumansai/core && brew install openhuman ; valider CLT si demandé.
Démarrer OpenHuman depuis ~/Applications ; approuver tous les dialogues confidentialité.
Terminer setup LLM et au moins une intégration OAuth dans le navigateur distant.
Attendre la première sync Memory Tree (coche verte) ; poser une question spécifique au connecteur pour vérifier le rappel.
Après acceptation, OpenHuman peut rester en ligne 24h/24 sur le Mac distant pendant que vous ne vous connectez en VNC depuis Windows ou Linux qu'à la demande. Idéal pour les équipes sans budget Mac local qui ont besoin de sessions bureau persistantes conformes RGPD.
Oui. L'UI utilise WebKit ; l'inférence passe par API ou Ollama. L'ANE Apple Silicon aide Ollama local mais reste optionnel.
Vectorisation initiale de l'historique des connecteurs autorisés dans un graphe local — typiquement 10–25 minutes. Réseau stable, ne pas forcer la fermeture.
Homebrew : brew upgrade openhuman. Installs .dmg : mise à jour in-app ou dernière release. En Early Beta, surveillez les release notes.
OpenHuman abaisse la barrière pour une couche IA personnelle avec onboarding GUI, Memory Tree et intégrations profondes — mais cette valeur dépend d'un accès bureau persistant pour permissions et OAuth. Si votre machine quotidienne est Windows ou Linux, ou si vous voulez un Mac headless 24h/24, l'achat matériel ajoute amortissement et risque électrique ; un Mac loué avec VNC permet le setup GUI une fois et un agent toujours actif sans ops hardware local.
Les nœuds Mac distants VNCMac incluent un bureau graphique pour ce parcours d'acceptation — utilisez le bouton ci-dessous pour choisir un forfait, puis suivez notre guide de connexion pour entrer en VNC et exécuter la checklist de la section 07.