69f475ec78
- Add logwhisperer.sh script for tailing and monitoring system logs - Implement pattern matching for critical errors (FATAL, ERROR, OOM, segfault) - Add JSON payload generation with severity levels - Implement rate limiting and offset tracking per log source - Add install.sh with interactive configuration and systemd support - Create comprehensive test suite with pytest - Add technical specification documentation - Update CHANGELOG.md following Common Changelog standard All 12 tests passing. Follows Metodo Sacchi (Safety first, little often, double check).
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 settimane) 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 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 📺 Canale YouTube 🔗 LinkedIn ✉️ luca@lucasacchi.net
LogWhispererAI - "Safety first, little often, double check"