Comment installer nanobot sur un Mac mini

Ce qu’est nanobot

nanobot est un agent IA personnel open source du groupe HKUDS sur GitHub. Il est écrit en Python, sous licence MIT. Comme OpenClaw, il garde une mémoire, lance des outils et vous répond depuis des apps de messagerie. Son cœur reste petit et lisible (github.com/HKUDS/nanobot, lu le 2 octobre 2026). La dernière version sur PyPI était la 0.3.5, du 15 septembre 2026.

Vous pouvez l’utiliser dans une WebUI du navigateur, dans le terminal, ou depuis Telegram, Discord, Slack, l’e-mail et d’autres channels. Il peut travailler sur des fichiers, lancer des commandes shell, chercher sur le web, utiliser des serveurs MCP et exécuter des tâches planifiées. Une précision sur le nom. Ce n’est pas obot-platform/nanobot, qui est un framework Go pour créer des agents MCP.

Prérequis

• Python 3.11 ou plus récent. Vérifiez avec python3 --version. L’installeur s’arrête s’il n’en trouve pas. Installez donc Python d’abord si besoin.
• macOS 13 ou plus récent. Les paquets précompilés pour les Mac Apple silicon et Intel incluent la WebUI et l’interface terminal.
• Un fournisseur de modèle. Anthropic, OpenAI, OpenRouter et les serveurs locaux comme Ollama sont tous couverts dans la documentation des fournisseurs. Utilisez une clé API du fournisseur choisi.
• Git et Bun, mais seulement si vous installez depuis les sources. L’installation normale n’en a pas besoin.

L’installer

Lancez l’installeur officiel en une commande, tiré du README.

curl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh

Il installe le paquet nanobot-ai depuis PyPI. Il évite les installations pip au niveau du système. Il utilise un environnement virtuel actif, uv, pipx, ou son propre environnement dans le dossier .nanobot de votre dossier personnel. Il affiche ensuite la commande exacte utilisée. Pour voir le plan sans rien modifier, ajoutez l’option dry run.

curl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh -s -- --dry-run

Si vous utilisez déjà uv, ceci fait le même travail. Vérifiez ensuite la version.

uv tool install nanobot-ai
nanobot --version

Premier lancement et choix d’un modèle

Le README recommande la WebUI pour le premier lancement. Elle s’ouvre sur 127.0.0.1, port 8765, et n’écoute que sur ce Mac.

nanobot webui

Ouvrez Settings, puis Models. Choisissez un fournisseur, collez sa clé API et choisissez un modèle. Lancez ensuite un nouveau sujet et envoyez Hello. Toute réponse normale signifie que le fournisseur, le modèle et le gateway fonctionnent ensemble. Depuis le terminal, un message unique fait la même vérification.

nanobot -m "Hello!"

Les réglages sont enregistrés dans config.json, dans le dossier .nanobot de votre dossier personnel. Nous n’avons pas encore lancé cette installation sur notre propre machine de test. Les commandes ici sont copiées du README et de la documentation de nanobot au 2 octobre 2026.

Le faire tourner 24/7

Le gateway est la partie qui reste en ligne. Il fait tourner les apps de messagerie, les tâches planifiées et le travail de mémoire. Cette commande le garde actif après la fermeture du terminal.

nanobot gateway --background

Cela ne survit pas à un redémarrage. Pour cela, la documentation de déploiement installe un LaunchAgent. Terminez d’abord la configuration du modèle dans la WebUI. Prévisualisez ensuite le fichier de service et installez-le.

nanobot gateway install-service --manager launchd --dry-run
nanobot gateway install-service --manager launchd

Il écrit ai.nanobot.gateway.plist dans le dossier LaunchAgents de la Library de votre dossier personnel. Il démarre le gateway avec le même Python que celui qui a installé nanobot. Les logs vont dans le dossier logs, à l’intérieur de .nanobot. S’il échoue avec address already in use, arrêtez d’abord le gateway lancé à la main.

launchctl list | grep ai.nanobot.gateway
launchctl kickstart -k gui/$(id -u)/ai.nanobot.gateway
nanobot gateway uninstall-service --manager launchd

Le gateway ne lit config.json qu’au démarrage. Redémarrez-le après chaque changement de config.

Un LaunchAgent ne tourne que si un utilisateur a ouvert sa session. Sur un Mac sans surveillance, activez l’ouverture de session automatique pour le compte qui fait tourner nanobot. Empêchez ensuite le Mac de se mettre en veille. La veille met en pause le gateway et ses tâches planifiées.

sudo pmset -a sleep 0
sudo pmset -a disksleep 0
sudo pmset -a displaysleep 10

Plus de détails dans ce qui se passe quand un Mac se met en veille et dans le guide du Mac toujours allumé.

Notes de sécurité

• Pour la production, la documentation conseille deux réglages ensemble. Mettez restrictToWorkspace à true, et tools.exec.sandbox à seatbelt sur macOS. Seatbelt limite les commandes shell au dossier de travail.
• Aucun des deux ne limite l’accès réseau. Gardez les secrets hors du dossier de travail.
• La WebUI et la vérification de santé du gateway écoutent sur 127.0.0.1 par défaut. Laissez-les accessibles depuis ce Mac uniquement.
• Les expéditeurs inconnus sur les apps de messagerie reçoivent un code d’appairage, pas une réponse. Vous les approuvez avec /pairing approve et leur code.
• La documentation conseille des références à des variables d’environnement pour les clés API, plutôt que des clés en clair dans config.json. Dans tous les cas, traitez le dossier .nanobot comme un fichier de mots de passe.

La protection la plus simple est un Mac qui ne contient rien d’autre à vous. Si l’agent fait quelque chose d’étrange, les dégâts s’arrêtent à cette machine.

Le faire tourner sur un Mac MacRun

Notre offre Agent est un Mac mini dédié qui ne se met jamais en veille. Il est installé dans notre propre site privé dans le New Jersey. Sa session revient toute seule après un redémarrage, donc le LaunchAgent de nanobot redémarre aussi. Claude Code et Codex sont préinstallés. nanobot ne l’est pas. Vous l’installez vous-même, avec Python si besoin, car vous avez tous les droits administrateur.

Vous pouvez ouvrir la WebUI dans le navigateur du Mac lui-même, via notre bureau dans le navigateur. L’offre Agent coûte $169 par mois. MacRun ne vend pas de clés API. Utilisez une clé API de votre fournisseur de modèle, qui vous facture l’usage selon ses propres conditions.

Quand vous n’avez pas besoin de MacRun

nanobot est léger et tourne presque partout. La documentation couvre les services Linux, Docker et un déploiement Render en un clic. Si vous n’avez besoin de rien de macOS, chacune de ces options coûte moins cher qu’un Mac. Et si vous avez déjà un Mac qui reste allumé avec une session ouverte, utilisez-le.

MacRun sert au travail de développement, selon notre politique d’utilisation acceptable. Un nanobot qui trie des issues ou fait l’entretien nocturne des dépôts a sa place. Un nanobot qui gère votre boîte mail personnelle ne l’a pas. Pour comparer les offres, consultez la page du Mac pour agents.