Come installare nanobot su un Mac mini

Cos’è nanobot

nanobot è un agente AI personale open source del gruppo HKUDS su GitHub. È scritto in Python, con licenza MIT. Come OpenClaw, conserva la memoria, usa strumenti e ti risponde dalle app di chat. Il suo nucleo è tenuto piccolo e leggibile (github.com/HKUDS/nanobot, letto il 2 ottobre 2026). L’ultima release su PyPI era la 0.3.5, del 15 settembre 2026.

Puoi usarlo in una WebUI nel browser, nel terminale, oppure da Telegram, Discord, Slack, Email e altri canali. Può lavorare con i file, eseguire comandi shell, cercare sul web, usare server MCP ed eseguire job pianificati. Un’ultima nota sul nome. Non è obot-platform/nanobot, che è un framework Go per creare agenti MCP.

Requisiti

• Python 3.11 o successivo. Verifica con python3 --version. L’installer si ferma se non lo trova, quindi se serve installa prima Python.
• macOS 13 o successivo. I pacchetti già compilati per i Mac Apple silicon e Intel includono la WebUI e l’interfaccia da terminale.
• Un provider di modelli. Anthropic, OpenAI, OpenRouter e server locali come Ollama sono tutti trattati nella documentazione sui provider. Usa una chiave API del provider che scegli.
• Git e Bun, ma solo se installi dai sorgenti. L’installazione normale non ne ha bisogno.

Installalo

Esegui l’installer ufficiale a un solo comando indicato nel README.

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

Installa il pacchetto nanobot-ai da PyPI. Evita le installazioni pip a livello di sistema. Usa un ambiente virtuale attivo, uv, pipx, oppure un suo ambiente nella cartella .nanobot della tua home. Poi stampa il comando esatto che ha usato. Per vedere il piano senza cambiare nulla, aggiungi il flag di dry run.

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

Se usi già uv, questo fa lo stesso lavoro. Poi controlla la versione.

uv tool install nanobot-ai
nanobot --version

Primo avvio e un modello

Per il primo avvio il README consiglia la WebUI. Si apre su 127.0.0.1, porta 8765, e ascolta solo su questo Mac.

nanobot webui

Apri Settings, poi Models. Scegli un provider, incolla la sua chiave API e scegli un modello. Poi apri un nuovo topic e invia Hello. Qualsiasi risposta normale vuol dire che provider, modello e gateway funzionano insieme. Dal terminale, un messaggio singolo fa lo stesso controllo.

nanobot -m "Hello!"

Le impostazioni vengono salvate in config.json nella cartella .nanobot della tua home. Non abbiamo ancora eseguito questa installazione sulla nostra macchina di test. I comandi qui sono copiati dal README e dalla documentazione di nanobot del 2 ottobre 2026.

Tienilo attivo 24/7

Il gateway è la parte che resta online. Tiene in funzione le app di chat, i job pianificati e il lavoro sulla memoria. Questo comando lo tiene attivo dopo che chiudi il terminale.

nanobot gateway --background

Però non sopravvive a un riavvio. Per quello, la documentazione sul deployment installa un LaunchAgent. Prima completa la configurazione del modello nella WebUI. Poi guarda in anteprima il file del servizio e installalo.

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

Scrive ai.nanobot.gateway.plist nella cartella LaunchAgents della Library nella tua home. Avvia il gateway con lo stesso Python che ha installato nanobot. I log finiscono nella cartella logs dentro .nanobot. Se fallisce con address already in use, ferma prima il gateway che hai avviato a mano.

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

Il gateway legge config.json solo all’avvio. Riavvialo dopo ogni modifica alla configurazione.

Un LaunchAgent gira solo mentre un utente ha fatto il login. Su un Mac senza supervisione, attiva il login automatico per l’account che esegue nanobot. Poi impedisci lo stop del Mac, perché lo stop mette in pausa il gateway e i suoi job pianificati.

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

Trovi più dettagli in cosa succede quando un Mac va in stop e nella guida al Mac sempre acceso.

Note di sicurezza

• Per la produzione, la documentazione consiglia due impostazioni insieme. Imposta restrictToWorkspace su true, e su macOS imposta tools.exec.sandbox su seatbelt. Seatbelt limita i comandi shell alla cartella del workspace.
• Nessuna delle due limita l’accesso alla rete. Tieni i segreti fuori dal workspace.
• La WebUI e il controllo di salute del gateway ascoltano di default su 127.0.0.1. Lasciali solo su questo Mac.
• I mittenti sconosciuti nelle app di chat ricevono un codice di abbinamento, non una risposta. Li approvi con /pairing approve seguito dal loro codice.
• Per le chiavi API, la documentazione suggerisce riferimenti a variabili d’ambiente invece delle chiavi in chiaro in config.json. In ogni caso, tratta la cartella .nanobot come un file di password.

La protezione più semplice è un Mac che non contiene nient’altro di tuo. Se l’agente fa qualcosa di strano, il danno si ferma a quella macchina.

Farlo girare su un Mac di MacRun

Il nostro piano Agent è un Mac mini dedicato che non va mai in stop. Si trova nella nostra struttura privata nel New Jersey. La sua sessione di login torna da sola dopo un riavvio, quindi il LaunchAgent di nanobot riparte. Claude Code e Codex sono preinstallati. nanobot no. Lo installi tu, insieme a Python se serve, perché hai pieni diritti di amministratore.

Puoi aprire la WebUI nel browser del Mac stesso, tramite il nostro desktop nel browser. Il piano Agent costa $169 al mese. MacRun non vende chiavi API. Usa una chiave API del tuo provider di modelli, che ti fattura l’uso secondo i suoi termini.

Quando non ti serve MacRun

nanobot è piccolo e gira quasi ovunque. La documentazione copre servizi Linux, Docker e un deploy su Render con un clic. Se da macOS non ti serve nulla, ognuna di queste opzioni costa meno di un Mac. E se hai già un Mac che resta acceso e con il login fatto, usa quello.

MacRun è pensato per il lavoro di sviluppo, secondo la nostra policy di utilizzo accettabile. Un nanobot che smista le issue o esegue lavori notturni sul repository va bene. Uno che gestisce la tua casella email personale no. Per confrontare i piani, vedi la pagina del Mac per agenti.