ServerPulse brings advanced analytics, live alerts, and AI-generated insights directly to your Discord server.

• ServerPulse continuously tracks your Discord server’s activity like messages, joins, reactions, and more, and turns that data into actionable insights.
• It’s powered by a multi-provider AI layer (Gemini, OpenAI, Grok, OpenRouter) that writes daily and weekly “Pulse Reports” right inside your Discord channel.

Use it for:

• 📈 Server growth tracking 
• 🧩 Engagement analysis 
• 💬 Community sentiment 
• 🎯 Activity alerts

• Tracks messages, joins/leaves, reactions, and voice activity
• Detects spikes, drops, or raids instantly
• Sends alerts automatically to a configured #serverpulse-updates channel

• /topmessagers [24h|7d|30d|all] — show most active users
• /leaderboard #channel — per-channel rankings
• Cached via Redis for speed

• Weekly “Pulse Reports” with:
  • Top users & busiest channels
  • Community sentiment breakdown
  • AI-suggested engagement improvements
• Supports Gemini, OpenAI, OpenRouter, and Grok
• Each guild can bring its own AI key

• No raw messages or attachments stored
• Only aggregated counts & IDs saved
• Channel tracking is opt-in (/add-collect-channel)
• Default retention: 90 days (configurable)

git clone https://github.com/Sahaj33-op/ServerPulse.git
cd ServerPulse
cp .env.example .env
# Edit your BOT_TOKEN and (optionally) AI keys
docker compose up --build -d

That’s it. ServerPulse, MongoDB, and Redis will start together automatically.

See .env.example for template.

┌──────────────────────────┐
│ discord.py Event Stream  │
└────────────┬─────────────┘
             │
             ▼
┌──────────────────────────┐
│  Metrics Collector       │
│  (messages, joins, etc.) │
└────────────┬─────────────┘
             │
             ▼
┌──────────────────────────┐
│ MongoDB + Redis Cache    │
└────────────┬─────────────┘
             │
             ▼
┌──────────────────────────┐
│ AI Adapter Layer         │
│ (Gemini / OpenAI / ...)  │
└────────────┬─────────────┘
             │
             ▼
┌──────────────────────────┐
│ Discord Update Channel   │
│ (reports + alerts)       │
└──────────────────────────┘

• Language: Python 3.11+
• Framework: discord.py v2
• Database: MongoDB 6 + Redis
• Scheduler: discord.ext.tasks.loop
• AI Layer: Gemini / OpenAI / OpenRouter / Grok
• Containerization: Docker + Compose

Pull requests welcome! Focus areas:

• New AI integrations (Claude, Cohere)
• Smarter anomaly detection
• Localization / translations
• Enhanced metrics visualization

See CONTRIBUTING.md for details.

MIT License © 2025 Sahaj Italiya

• Issues → GitHub Issues
• Email → [email protected]