lucasacchi/LogWhispererAI
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update README.md

Browse Source 
refactor on readme.md
This commit is contained in:
lucasacchi
2026-04-02 15:42:06 +02:00
parent adfdec41a6
commit ed6185b2e4
1 changed files with 12 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

15
README.md
View File

@@ -1,20 +1,28 @@
LogWhispererAI 🌌 LogWhispererAI 🌌 aka Sacchi's Server Sentinel
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. VP: 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 🎯 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. 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) 🚀 Funzionalità MVP (Lancio in 4 giorni)
Log Ingestion: Script Bash leggero per il monitoraggio (tail -f) di log critici (syslog, nginx, postgres). 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). 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. Alerting Umano: Notifiche su Telegram/Slack con sintesi del problema, severità e comando esatto per la mitigazione.
🛠️ Stack Tecnologico 🛠️ Stack Tecnologico
Core Logic: Python 3.12+ (in venv) Core Logic: Python 3.12+ (in venv)
Automation: n8n (self-hosted) Automation: n8n (self-hosted)
Database: Supabase / PostgreSQL Database: Supabase / PostgreSQL
AI: GPT-4o-mini / Claude 3.5 Sonnet AI: GPT-4o-mini / Claude 3.5 Sonnet
Agentic Dev: OpenCode.ai Agentic Dev: OpenCode.ai
🛠️ Setup per lo Sviluppo 🛠️ Setup per lo Sviluppo
Il progetto segue una metodologia Spec-Driven e TDD (Test-Driven Development). Il progetto segue una metodologia Spec-Driven e TDD (Test-Driven Development).
# Clone e setup # Clone e setup
git clone [https://github.com/LucaSacchiNet/LogWhispererAI.git](https://github.com/LucaSacchiNet/LogWhispererAI.git) git clone [https://github.com/LucaSacchiNet/LogWhispererAI.git](https://github.com/LucaSacchiNet/LogWhispererAI.git)
cd LogWhispererAI cd LogWhispererAI
@@ -36,6 +44,7 @@ opencode
Git: Conventional Commits (feat, fix, docs, test). Git: Conventional Commits (feat, fix, docs, test).
Changelog: Common Changelog standard. Changelog: Common Changelog standard.
Testing: Pytest per la logica Python e test di integrazione per gli script bash. Testing: Pytest per la logica Python e test di integrazione per gli script bash.
⚖️ Licenza e Note Legali ⚖️ Licenza e Note Legali
Questo software è proprietà riservata di Luca Sacchi Ricciardi. 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. 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.