OpenHuman par TinyHumans AI est un assistant de bureau open source, UI-first, qui construit un Memory Tree et un coffre Markdown compatible Obsidian sur votre Mac, rafraîchi par auto-fetch toutes les 20 minutes sur 118+ intégrations OAuth (Gmail, GitHub, Slack, Notion, Linear, Jira, etc.). Contrairement aux harnesses terminal-first, vous passez de l’installation à un agent utile en quelques minutes sur macOS, avec Ollama optionnel pour l’inférence locale. Ce guide Type A couvre l’installation Homebrew (préférée à curl | bash), les chemins d’architecture, un runbook en sept étapes, les paliers RAM sur Mac mini M4 et le staging sur Mac mini cloud (~16,9 $/jour sur la grille tarifaire MacHTML publiée).
Associez OpenClaw webhooks et Ollama sur Mac cloud pour l’automatisation gateway, TradingAgents + Ollama sur M4 pour les splits multi-agents, et Mac mini M4 cloud pour le contexte matériel. Documentation officielle : OpenHuman docs ; matériel : fiches techniques Mac mini Apple (jusqu’à 32 Go de mémoire unifiée sur M4).
Divulgation : MacHTML fournit la location de Mac mini cloud mentionnée dans cet article.
Pourquoi OpenHuman sur Mac mini M4
La plupart des agents repartent à zéro à chaque session. OpenHuman synchronise toutes les 20 minutes et compresse via TokenJuice (jusqu'à ~80 % de tokens en moins) avant chaque appel modèle. Les données restent en local (SQLite + .md Obsidian).
Le Mac mini M4 convient à un agent toujours actif et à Ollama en sidecar. 16 Go impose de petits modèles ; 24–32 Go permettent des routes quantifiées plus lourdes. Voir staging OpenClaw GLM pour les gateways.
Réservez au moins 30 Go de disque pour le vault et le cache Ollama.
Architecture : Memory Tree et services managés
| Couche | Emplacement | Contenu |
|---|---|---|
| Memory Tree | SQLite local + chunks Markdown (≤3k tokens) | Résumés mail, dépôts, calendrier |
| Vault Obsidian | Fichiers .md locaux | Miroir éditable de la mémoire |
| Config | config.toml local | Routage modèle, memory.backend = "agentmemory" optionnel |
| Backend managé | OpenHuman (défaut) | Connexion, proxy modèle, OAuth Composio |
Flux : OAuth → Composio → auto-fetch 20 min → Markdown → SQLite → TokenJuice → Ollama optionnel.
Le Memory Tree est local ; l'expérience par défaut utilise encore l'auth et Composio managés (README upstream).
OpenHuman vs OpenClaw
| Axe | OpenClaw | OpenHuman |
|---|---|---|
| Démarrage | Terminal-first | UI-first, quelques minutes |
| Mémoire | Dépend des plugins | Memory Tree + auto-fetch 20 min |
| Intégrations | Câblage manuel | 118+ OAuth (Composio) |
| LLM local | Ollama manuel | Routage intégré + Ollama |
| Mac mini | Gateways, webhooks | Contexte personnel persistant |
Recommandation : webhooks → OpenClaw. Contexte persistant → OpenHuman + splits RAM TradingAgents.
Runbook d'installation macOS
- Installation Homebrew (recommandée) :
brew tap tinyhumansai/openhuman brew install openhuman - Lancer OpenHuman.app depuis
/Applicationset se connecter. - Réglages → Intégrations : OAuth Gmail, GitHub ou Slack.
- Attendre ~20 minutes pour le premier auto-fetch ; vérifier les
.mddans Réglages → Mémoire. - Activer Ollama (Routage modèle → IA locale) :
ollama servepuis modèle adapté à la RAM. - Vérifier l'agent : demander un résumé GitHub ; les citations doivent pointer vers le vault.
- Option agentmemory :
memory.backend = "agentmemory"dansconfig.toml.
Éviter en production : curl | bash sans vérification d'intégrité — préférer Homebrew ou le .dmg signé.
Ollama local sur Apple Silicon
| RAM unifiée | Modèle Ollama | Charge OpenHuman |
|---|---|---|
| 16 Go | llama3.2:3b + llama3.1:8b | Résumés légers |
| 24 Go | qwen2.5:14b + llama3.2:3b | Recherche + chat |
| 32 Go | qwen2.5:32b (Q4) | Compression vault lourde |
brew install ollama
ollama pull llama3.1:8b
ollama servePointer le routage local vers http://127.0.0.1:11434 — voir la doc IA locale et TradingAgents sur M4.
Staging Mac mini cloud
Louez un Mac mini M4 si le portable dort (auto-fetch stoppé), pour isoler OAuth, ou si la sync vault est lente — à partir d'16,9 $/jour (MacHTML). Vérifiez du -sh sur le vault avant location longue.
Suivez staging OpenClaw GLM : comptes test séparés, snapshot vault, caffeinate -dims au premier cycle.
Dépannage
Vault vide après 30+ minutes
Symptôme : OAuth connecté, pas de .md.
Correctif : Vérifier le backend managé, ré-autoriser OAuth, pare-feu macOS, sync manuelle ; sur cloud Mac utiliser caffeinate -dims.
Ollama connection refused
Symptôme : port 11434 refusé.
Correctif : ollama serve, curl http://127.0.0.1:11434/api/tags, modèle plus petit sur 16 Go, build ARM64 sur cloud Mac.
FAQ
Q : OpenHuman est-il entièrement hors ligne ?
R : Non — auth et Composio managés par défaut ; Memory Tree local.
Q : Différence avec OpenClaw ?
R : OpenClaw = gateways ; OpenHuman = mémoire personnelle + auto-fetch UI.
Q : Quelle RAM ?
R : 16 Go min. ; 24 Go recommandé — voir TradingAgents M4.
Q : Où est le vault ?
R : Réglages → Mémoire → chemin du vault ; sauvegarde Time Machine avant mise à jour macOS.
Staging OpenHuman sur Mac mini cloud
Louez un Mac mini M4 toujours actif pour l'auto-fetch 20 min, OAuth et Ollama pendant que votre portable dort.