Back to portfolio

AI & Automation · 2026

AgentSmith: un agente AI che controlla la casa da Telegram

Un agente conversazionale che gira su un mini PC da pochi watt. Gli scrivo su Telegram in linguaggio naturale e lui comanda i dispositivi IoT che ho costruito in questi anni.

AgentSmith è un agente conversazionale che gira su un mini PC fanless da pochi watt. Gli scrivo su Telegram in linguaggio naturale, per esempio “accendi l’aria condizionata”. Un LLM interpreta la richiesta, sceglie tramite function calling quale azione eseguire e manda il comando ai dispositivi ESP della rete di casa. Poi risponde con l’esito.

Le ESP sono dei microcontrollori tipo Arduino ma con accesso wi-fi, scrivendo il firmware si può creare degli oggetti IoT connessi alla rete di casa e si può costruire un sistema di domotica personalizzato.

Come funziona

  1. Il messaggio arriva al bot Telegram sul mini PC.
  2. Il testo va al modello Claude Haiku 4.5 via API, insieme alla definizione dei tool (le ESP) disponibili e delle action (ad es. set_light, read_sensor, air_conditioned…).
  3. Il modello restituisce una chiamata strutturata; l’agente la valida e la esegue chiamando l’endpoint sull’ESP corrispondente.
  4. Lo stato letto dal dispositivo torna al modello, che formula la risposta.

L’LLM non tocca mai direttamente l’hardware: decide cosa fare, mentre il codice controlla se può farlo.

Architettura

  • Mini PC fanless (Intel Atom x5-Z8350, 4 GB RAM) con Ubuntu Server 24.04 headless
  • Nessun LLM locale: l’hardware minimo gestisce orchestrazione e I/O, il modello gira via API
  • Accesso remoto solo tramite VPN WireGuard e SSH con chiave
  • Dispositivi ESP32 in rete locale su protocollo HTTP, con firmware scritto in C++

Sullo stesso nodo
Un secondo bot Telegram, in Python, raccoglie note e scoperte inviate dal mio utente nella chat e le salva come Markdown in un vault personale versionato con git, con un mirror di backup su GitHub. Questa repo è il mio Second Brain che uso quotidianamente per lavorare sulla conoscenza.

Cosa ho imparato
Accesso a bot Telegram tramite polling e filtro di sicurezza sull’utente. Architettura di un Second Brain. Ragionamenti sull’opportunità di utilizzare un LLM sul Second Brain.

Technologies

  • Claude API
  • ESP32
  • Iot
  • Linux
  • Python
  • Telegram BOT
  • WireGuard