Guide de démarrage d’OpenHuman : un assistant IA open source plus simple à utiliser que OpenClaw

GitHub : https://github.com/tinyhumansai/openhuman

Présentation du projet

OpenHuman est un assistant IA personnel open source ultra-intelligent. Son idée centrale est « d’intégrer vraiment l’IA à votre vie quotidienne ». Par rapport à OpenClaw, la différence majeure d’OpenHuman, c’est sa conception orientée UI : vous n’avez pas besoin de bricoler des fichiers de configuration ni de saisir des commandes. De l’installation à l’obtention d’un agent IA fonctionnel, il ne faut que quelques clics.

Le projet propose plusieurs fonctionnalités qui frappent par leur originalité :

• 118+ intégrations OAuth en un clic : Gmail, Notion, GitHub, Slack, Calendar, etc. — une autorisation et c’est parti
• Arbre de mémoires + Obsidian Wiki : compression automatique des e-mails, documents et historiques de chat en Markdown, puis stockage local dans une base SQLite et dans un dépôt Obsidian
• TokenJuice pour une compression intelligente : chaque requête est compressée avant d’atteindre le LLM ; la consommation de tokens peut diminuer jusqu’à 80%
• Routage natif des modèles : sous un même abonnement, les tâches sont automatiquement réparties vers le modèle le mieux adapté (modèles orientés raisonnement, rapides ou vision)
• Support vocal natif : entrée STT, sortie ElevonLabs TTS, synchronisation des mouvements de la bouche du mascotte

Difficulté / durée / ce que vous obtenez

• Difficulté : ⭐⭐☆☆☆ (niveau débutant)
• Durée : environ 15–20 minutes (de zéro à opérationnel)
• Ce que vous obtenez : installer et configurer localement, intégrer des services OAuth, et utiliser le système de mémoires

Public cible

• Des développeurs qui veulent essayer un assistant IA open source, mais qui ne veulent pas passer du temps à configurer le terminal
• Des travailleurs du savoir qui ont besoin d’un système local de gestion des connaissances
• Des utilisateurs intéressés par OpenClaw, mais qui trouvent la barrière d’entrée trop élevée
• Des personnes orientées productivité qui veulent que l’IA synchronise automatiquement calendrier, e-mails et documents

Dépendances et environnement essentiels

Environnement requis

Dépendances supplémentaires pour Windows

# Visual Studio C++ Build Tools (inclut MSVC v143 et le SDK Windows 11)
# Lors de l’installation, choisir "Default installation"

# LLVM/Clang (dépendance à libclang)
# Télécharger la version Windows x64 depuis https://github.com/llvm/llvm-project/releases
# Lors de l’installation, cocher "Add LLVM to system PATH for all users"

# CMake
winget install Kitware.CMake

Vérifier l’installation

rustc --version    # devrait afficher 1.93.0 ou une version ultérieure
cargo --version
clang --version
cmake --version
node --version     # devrait afficher v24.x.x ou une version ultérieure
pnpm --version     # devrait afficher 10.10.0

Structure complète du projet

openhuman/
├── app/                         # espace de travail pnpm : openhuman-app
│   ├── src/                     # code source React front-end
│   │   ├── components/         # composants UI
│   │   ├── services/          # client API/RPC
│   │   ├── store/             # gestion d’état Redux
│   │   └── utils/             # fonctions utilitaires
│   ├── src-tauri/               # coquille desktop Tauri
│   └── package.json
├── src/                         # bibliothèque cœur en Rust
│   ├── core/                    # couche de transport (HTTP/JSON-RPC/CLI)
│   │   ├── jsonrpc.rs           # serveur JSON-RPC
│   │   ├── cli.rs              # interface en ligne de commande
│   │   └── event_bus/           # bus d’événements
│   └── openhuman/              # domaine métier
│       ├── memory/             # système de mémoires
│       ├── tokenjuice/         # compression Token
│       ├── integrations/       # intégrations OAuth
│       └── ...
├── scripts/                     # scripts d’installation et de debug
│   ├── install.sh              # installation en un clic macOS/Linux
│   ├── install.ps1             # installation en un clic Windows
│   └── load-dotenv.sh          # chargement des variables d’environnement
├── gitbooks/                    # documentation officielle
├── Cargo.toml                   # configuration des dépendances Rust
└── package.json                 # configuration des dépendances Node

Étapes pas à pas

Étape 1 : installation en un clic

macOS / Linux

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

Windows

irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex

Le script d’installation détecte automatiquement votre environnement système, puis télécharge les binaires correspondant à la plateforme (DMG/EXE).

Étape 2 : compiler depuis le code source (optionnel)

Si vous souhaitez participer au développement ou utiliser les dernières fonctionnalités :

# 1. Forker et cloner le dépôt
git clone https://github.com/tinyhumansai/openhuman.git
cd openhuman

# 2. Initialiser les sous-modules
git submodule update --init --recursive

# 3. Installer les dépendances
pnpm install

# 4. Développement Web UI uniquement
pnpm dev

# 5. Développement de l’application desktop complète
pnpm dev:app

Étape 3 : configurer la clé API

Copiez le modèle de variables d’environnement :

cp .env.example .env

Modifiez le fichier .env pour configurer votre fournisseur de LLM :

# Choisissez un ou plusieurs fournisseurs de modèles

# Claude (recommandé)
ANTHROPIC_API_KEY=sk-ant-xxxxx

# OpenAI GPT
OPENAI_API_KEY=sk-xxxxx

# Google Gemini
GEMINI_API_KEY=xxxxx

Étape 3.5 : utiliser Defapi pour réduire les coûts (recommandé)

Si vous trouvez que les prix des API officiels sont trop élevés, vous pouvez utiliser Defapi — un service de proxy compatible avec l’API OpenAI v1/chat/completions, dont le coût est inférieur (environ moitié du prix officiel).

Defapi prend en charge les protocoles suivants :

• v1/chat/completions (compatible OpenAI)
• v1/messages (compatible Anthropic)
• v1beta/models/ (liste des modèles)

La configuration est simple : il suffit de remplacer l’URL d’API par celle de Defapi et de remplacer la clé API.

# Exemple de configuration Defapi
ANTHROPIC_API_KEY=dk-xxxxx        # La clé Defapi commence par "dk-"
OPENAI_API_KEY=dk-xxxxx

# Ou bien définir l’endpoint via base_url (si OpenHuman le supporte)
ANTHROPIC_BASE_URL=https://api.defapi.org/v1
OPENAI_BASE_URL=https://api.defapi.org/v1/chat

Defapi propose notamment les modèles suivants :

• anthropic/claude-sonnet-4.5 / claude-opus-4.5 / claude-haiku-4.5
• openai/gpt-4o / gpt-4o-mini / gpt-5
• google/gemini-3-flash

Étape 4 : intégration des services OAuth

Après avoir lancé l’application, dans l’interface :

1. Allez dans Settings → Integrations
2. Cliquez sur le service que vous souhaitez intégrer (Gmail, Notion, GitHub, etc.)
3. Terminez le flux d’autorisation OAuth

Ou bien configurez via des variables d’environnement :

# Gmail OAuth
GMAIL_CLIENT_ID=xxxxx
GMAIL_CLIENT_SECRET=xxxxx

# GitHub OAuth
GITHUB_CLIENT_ID=xxxxx
GITHUB_CLIENT_SECRET=xxxxx

Étape 5 : configurer le système de mémoires

Le système de mémoires d’OpenHuman synchronise automatiquement vos données. Les paramètres clés :

# Intervalle de synchronisation des mémoires (par défaut : 20 minutes)
OPENHUMAN_MEMORY_SYNC_INTERVAL=20

# Chemin du dépôt Obsidian
OPENHUMAN_OBSIDIAN_VAULT_PATH=~/Documents/openhuman-vault

# Niveau de compression TokenJuice
OPENHUMAN_TOKENJUICE_COMPRESSION=high

Les données de mémoires sont stockées localement dans SQLite :

# Chemin de stockage par défaut
~/.openhuman/memory.db

Étape 6 : démarrer et vérifier

Application desktop

# macOS
open -a OpenHuman

# Linux
openhuman-app

# Windows
OpenHuman.exe

Mode CLI

# Démarrer le service cœur
openhuman serve

# Dialogue interactif
openhuman run

Vérifier l’état de fonctionnement

# Vérifier la santé (health)
curl http://127.0.0.1:7788/health

# Voir le token cœur
cat ~/.openhuman/core.token

Dépannage des questions fréquentes

1. Le script d’installation renvoie une erreur « command not found »

Assurez-vous que curl et les outils réseau nécessaires sont installés :

# macOS
brew install curl

# Ubuntu/Debian
sudo apt install curl

# Windows (PowerShell 7+)
scoop install curl

2. Échec du lancement de l’application desktop

Vérifiez les dépendances Tauri :

# Vérification spécifique Windows
$env:LIBCLANG_PATH = "C:\\Program Files\\LLVM\\bin"
clang -v
cmake --version

Assurez-vous que Visual Studio Build Tools est installé et inclut la charge de travail « Desktop development with C++ ».

3. Échec de l’autorisation OAuth

Vérifiez que l’URL de rappel est correctement configurée :

http://localhost:7788/oauth/callback

Ajoutez cette URI de redirection dans les paramètres de l’application OAuth.

4. La synchronisation des mémoires ne fonctionne pas

Étapes de vérification :

# 1. Vérifier les logs du cœur
tail -f ~/.openhuman/logs/core.log

# 2. Déclencher la synchronisation manuellement
openhuman memory sync

# 3. Vérifier que le dépôt Obsidian est accessible en écriture
ls -la ~/Documents/openhuman-vault

5. La compression TokenJuice ne fonctionne pas

Confirmez que la compression est activée :

# Dans .env
OPENHUMAN_TOKENJUICE_ENABLED=true
OPENHUMAN_TOKENJUICE_LEVEL=high

# Redémarrer le service cœur
openhuman restart

6. Le routage des modèles n’est pas pris en compte

Vérifiez la configuration des modèles :

# Voir la configuration actuelle
openhuman config show

# Spécifier manuellement le modèle
OPENHUMAN_MODEL=claude-sonnet-4-20250514

7. Échec de connexion Defapi ou erreur 401

Si vous utilisez Defapi et rencontrez des problèmes de connexion ou une erreur 401 :

# 1. Vérifier que le format de la clé API Defapi est correct
# Correct : ANTHROPIC_API_KEY=dk-1234567890abcdef
# Incorrect : ANTHROPIC_API_KEY=sk-ant-xxxxx (format officiel)

# 2. Vérifier que base_url est correctement défini
ANTHROPIC_BASE_URL=https://api.defapi.org/v1

# 3. Vérifier que le nom du modèle est bien pris en charge par Defapi
# Format : developer/model (ex. anthropic/claude-sonnet-4.5)

# 4. Tester la connectivité de Defapi
curl https://api.defapi.org/v1/models \
  -H "Authorization: Bearer dk-votreCle"

Si vous avez vérifié tout le reste mais que l’erreur persiste, allez sur le site de Defapi pour confirmer l’état du compte et le solde.

Pour aller plus loin

• Documentation officielle — documentation complète sur GitBook
• Conception de l’architecture — pour comprendre en profondeur l’architecture du système
• Backend agentmemory — mémoire partagée avec Claude Code/Cursor
• Configuration du routage des modèles — comment optimiser le choix du modèle
• Fonctionnalité de synchronisation automatique — principe de la synchronisation automatique toutes les 20 minutes

---

Projets associés

• OpenClaw — un autre agent IA open source populaire
• agentmemory — backend de mémoires partagé
• Obsidian — outil de base de connaissances locale