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
• 🐳 Docker Ready - Full containerization support
• 🛡️ Production Ready - Rate limiting, deduplication, caching

🚀 Quick Start

Option 1: Download Binary (Easiest)

# Download latest release
wget https://github.com/yourusername/logwhisperer/releases/latest/download/logwhisperer_linux_x86_64.zip
unzip logwhisperer_linux_x86_64.zip
sudo ./install.sh

# Test it
logwhisperer test

Option 2: Docker (Recommended)

# Clone and run with docker-compose
git clone https://github.com/yourusername/logwhisperer.git
cd logwhisperer
docker-compose up -d

Option 3: From Source

# Clone and install
git clone https://github.com/yourusername/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

CI/CD

# Tag a release
git tag v1.0.0
git push origin v1.0.0
# GitHub Actions handles the rest!

🐳 Docker

# Quick start
docker-compose up -d

# With external Ollama
docker-compose --profile external-ollama up -d

# Development mode
docker-compose --profile development up

📚 Documentation

• Full Documentation
• Configuration Guide
• Docker Guide
• Development Guide

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide.

# Setup dev environment
git clone https://github.com/yourusername/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
• Docker Hub
• Issues
• Discussions

---

Made with ❤️ by the LogWhisperer Team