Active··2 min read
Homelab Agent
Agente AI autonomo per la gestione dell'infrastruttura Proxmox VE con orchestrazione MetaMCP, grafi di esecuzione LangGraph e memoria ibrida a 3 livelli.
AI / MLWeb / BackendExperiments / Tools
Stack
PythonLangGraphFastAPIProxmox VEMetaMCPDocker
#Python#LangGraph#MetaMCP#Proxmox VE#Hybrid Memory#FastAPI
Panoramica
Homelab Agent è un agente AI autonomo progettato per monitorare, amministrare e orchestrare l'infrastruttura Proxmox VE attraverso protocolli MetaMCP e macchine a stati a grafo con LangGraph.
Architettura & Caratteristiche Chiave
- Memoria Conversazionale Ibrida a 3 Livelli:
- Tier 1 (In-Context): Sliding window sugli ultimi 20 messaggi combinata con un sommario incrementale via LLM limitato a ~2000 token per risposte sub-2s.
- Tier 2 (Session Archival): Archiviazione e recupero contestuale persistente su sessione.
- Tier 3 (File System Audit): Logging append-only in formato JSONL (
memory/{thread_id}.jsonl) per ripristino immediato dello stato e tracciabilità operativa.
- Esecuzione con Grafi di Stato LangGraph:
- Modalità operative dedicate: CHAT (conversazione), ASK (richiesta di chiarimento), ACT (esecuzione singola) e PLAN (piani multi-step complessi).
- Meccanismo di sicurezza Human-in-the-Loop (HITL) per azioni distruttive (es. arresto nodi, eliminazione container o snapshot rollback).
- Integrazione MetaMCP & Toolset:
- Connessione a 34+ tool specializzati esposti da server MCP per Proxmox, Pi-hole e Nginx Proxy Manager.
- Backend & Servizio:
- API reattiva costruita con FastAPI e containerizzata con Docker per il deployment continuo su Proxmox VE.
Stato del Progetto
Architettura di base, gestione della memoria ibrida e connessione MetaMCP completate e operative nell'infrastruttura di test dell'homelab.