51 lines
2.4 KiB
Markdown
51 lines
2.4 KiB
Markdown
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"
|
|
|