LogWhisperer 🔍

AI-powered log analysis and monitoring tool that uses local LLMs to provide intelligent insights from your system logs.

✨ Features

• 🤖 AI-Powered Analysis - Uses Ollama for local LLM processing
• 📊 Multiple Log Sources - Supports journalctl, files, and Docker containers
• 🚨 Real-time Alerts - Discord notifications with @mentions
• 🔍 Smart Summarization - Intelligent pattern detection
• 🛡️ Production Ready - Rate limiting, deduplication, caching

🚀 Quick Start

# Clone and install
git clone https://github.com/binary-knight/logwhisperer.git
cd logwhisperer
pip install -r requirements.txt
python logwhisperer.py --help

📖 Basic Usage

Summarize Logs

# Recent system errors
logwhisperer summarize --source journalctl --priority err

# Specific log file
logwhisperer summarize --source file --logfile /var/log/nginx/error.log

# Docker container
logwhisperer summarize --source docker --container myapp

Real-time Monitoring (PRO)

# Start monitoring with Discord alerts
logwhisperer monitor

# Monitor specific file
logwhisperer monitor --source file --file /var/log/app.log

⚙️ Configuration

Create /etc/logwhisperer/config.yaml:

# LLM Settings
model: mistral
ollama_host: http://localhost:11434

# Monitoring
monitor:
  webhook_url: https://discord.com/api/webhooks/YOUR_WEBHOOK
  escalation_level: ERROR
  
  # Discord @mentions (optional)
  discord_mentions:
    ERROR:
      - "123456789012345678"  # User ID
    CRITICAL:
      - "123456789012345678"  # User ID  
      - "&456789012345678901" # Role ID

🔨 Building from Source

Development

# Install dev dependencies
pip install -r requirements-dev.txt

# Run tests
pytest

# Build binary
./build.sh

📚 Documentation

• Full Documentation
• Quick Reference

🤝 Contributing

Contributions are welcome. Open an issue first for anything large.

# Setup dev environment
git clone https://github.com/binary-knight/logwhisperer.git
cd logwhisperer
pip install -r requirements-dev.txt
pre-commit install

📄 License

MIT License - see LICENSE for details.

🙏 Acknowledgments

• Ollama for local LLM support
• Nuitka for Python compilation
• All our contributors

🔗 Links

• Releases
• Issues

---

Made with ❤️ by the LogWhisperer Team