From adfdec41a6b090c2941af0c811b1e5abd90a05e3 Mon Sep 17 00:00:00 2001 From: Luca Sacchi Ricciardi Date: Thu, 2 Apr 2026 15:40:14 +0200 Subject: [PATCH] chores on README.md --- README.md | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 50 insertions(+) diff --git a/README.md b/README.md index e69de29..52bd961 100644 --- a/README.md +++ b/README.md @@ -0,0 +1,50 @@ +LogWhispererAI 🌌 +aka Sacchi's Server Sentinel +UVP: Il DevOps tascabile che traduce i crash del tuo server e ti dice l'esatto comando per risolverli in sicurezza, senza farti perdere ore su StackOverflow. +🎯 Visione del Progetto +LogWhisperer AI trasforma i log di sistema e database spesso incomprensibili in alert azionabili descritti in "plain language". È pensato per piccole web agency e freelance che gestiscono infrastrutture (AWS, DigitalOcean, VPS) senza avere un sistemista senior dedicato. +🚀 Funzionalità MVP (Lancio in 4 giorni) +Log Ingestion: Script Bash leggero per il monitoraggio (tail -f) di log critici (syslog, nginx, postgres). +AI Processing Pipeline: Workflow su n8n che analizza i log tramite LLM (OpenAI/Anthropic) applicando il Metodo Sacchi (Safety first, little often, double check). +Alerting Umano: Notifiche su Telegram/Slack con sintesi del problema, severità e comando esatto per la mitigazione. +🛠️ Stack Tecnologico +Core Logic: Python 3.12+ (in venv) +Automation: n8n (self-hosted) +Database: Supabase / PostgreSQL +AI: GPT-4o-mini / Claude 3.5 Sonnet +Agentic Dev: OpenCode.ai +🛠️ Setup per lo Sviluppo +Il progetto segue una metodologia Spec-Driven e TDD (Test-Driven Development). +# Clone e setup +git clone [https://github.com/LucaSacchiNet/LogWhispererAI.git](https://github.com/LucaSacchiNet/LogWhispererAI.git) +cd LogWhispererAI + +# Ambiente virtuale +python3 -m venv venv +source venv/bin/activate + +# Installazione dipendenze (TBD) +pip install -r requirements.txt + + +Regole degli Agenti (OpenCode.ai) +Il file AGENTS.md definisce il comportamento degli assistenti AI. Per avviare una sessione di sviluppo: +opencode + + +📜 Metodologia e Standard +Git: Conventional Commits (feat, fix, docs, test). +Changelog: Common Changelog standard. +Testing: Pytest per la logica Python e test di integrazione per gli script bash. +⚖️ Licenza e Note Legali +Questo software è proprietà riservata di Luca Sacchi Ricciardi. +Tutti i diritti sono riservati. Per ogni controversia derivante dall'uso o dallo sviluppo di questo software, il foro competente in via esclusiva è il Foro di Milano, Italia. +Per i dettagli completi, consultare il file LICENSE.md. +👨‍💻 Autore +Luca Sacchi Ricciardi +🌐 [Sito Web / Blog](https://lucasacchi.net) +📺 [Canale YouTube](https://www.youtube.com/@lucasacchinet) +🔗 [LinkedIn](https://www.linkedin.com/in/lucasacchi) +✉️ luca@lucasacchi.net +LogWhispererAI - "Safety first, little often, double check" +