A feature-rich Discord bot with modular architecture and modern web interface
HazeBot is a comprehensive Discord bot built with Python and discord.py, featuring modular cogs, RESTful API, and a modern Flutter admin panel. Originally designed for The Chillventory server, it is easily adaptable for any community.
- 🎮 Gaming - Rocket League stats with rank tracking & Warframe market integration
- 🎭 Memes - Daily automated memes + custom generator (100+ templates)
- 🎫 Tickets - Support system with email transcripts & auto-archiving
- 🛠️ Moderation - Interactive mod panel with warnings & channel controls
- 📝 Management - AI-powered changelogs, todo lists, welcome system
- 🌐 REST API - Modular Blueprint architecture (300 lines vs 6500)
- 📱 Admin Panel - Flutter cross-platform app with Material Design 3
# Clone and setup
git clone https://github.com/inventory69/HazeBot.git
cd HazeBot
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -r requirements.txt
# Configure environment
cp .env.example .env
# Edit .env with your DISCORD_BOT_TOKEN and DISCORD_GUILD_ID
# Configure server IDs
# Edit Config.py PROD_IDS dictionary with your channel/role IDs
# Run bot only (APIServer cog is automatically skipped)
python Main.py# After completing basic setup above, install API dependencies:
pip install -r api_requirements.txt
# Add API configuration to .env:
# API_PORT=5070
# SECRET_KEY=your-secret-key-here # Generate: python -c "import secrets; print(secrets.token_hex(32))"
# API_ADMIN_USER=admin
# API_ADMIN_PASS=secure-password
# CORS_ORIGINS=https://your-domain.com,http://localhost:3000
# Run bot with API (loads APIServer cog automatically)
python start_with_api.pyNote: Main.py skips APIServer cog | start_with_api.py loads it
📖 Detailed Instructions: docs/BOT_SETUP.md
🔧 First Time? Follow the Complete Setup Guide for step-by-step instructions
- Rocket League - Stats, rank tracking, auto rank-up notifications
- Warframe - Market prices, item search, live alerts/fissures/invasions
- Automated daily posting from Reddit/Lemmy
- Custom generator with 100+ Imgflip templates
- Interactive creation with GUI configuration
- Interactive ticket system with real-time chat
- Admin panel integration with WebSocket updates
- Email transcripts and auto-archiving
- Smart push notifications (suppressed when viewing)
- Mod panel with mute/kick/ban/warn actions
- Message cache for instant loading
- SQLite database with table partitioning
- Real-time session tracking and active user monitoring
- Interactive dashboard with charts (user growth, devices, features)
- JWT authentication with admin/mod access control
- REST API for metrics and session details
- Performance optimized (cached aggregates, indexed queries)
- 📊 Analytics Documentation
- 22 modular cogs with hot-reload
- API Server as loadable Cog (Port 5070)
- Rich logging (console + Discord channel)
- Smart caching with TTL
📋 Complete Documentation Index - Comprehensive guide to all documentation
- 📖 Features - Complete feature list & commands
- 🔧 Bot Setup Guide - Discord bot installation & configuration
- 📋 Requirements - Dependencies & system requirements
- ⚡ Quick Start - Fast setup for development
- 🏗️ Architecture - Technical architecture & design patterns
- 🌐 REST API Documentation - Complete API reference with examples
- 📊 Analytics System - Analytics dashboard & tracking system
- 🔐 JWT Authentication Setup - Secure authentication guide
- 📦 Analytics Deployment - Analytics deployment checklist
- 📱 HazeBot Admin Panel - Flutter cross-platform app
- 🔧 Admin Panel Setup - Flutter app configuration
- 🚀 Deployment Checklist - Production deployment guide
- 🌐 NGINX Configuration - Web server setup
- ☁️ Cloudflare Tunnel - Secure tunnel setup
- 🤝 Contributing - Development guidelines & code style
- 🔄 API with Bot - Running API alongside bot
- ⚡ Performance Optimization - Speed improvements
- 🗄️ SQLite Migration Guide - Database migration
- 💾 Session Cache Improvements - Caching strategies
- Python 3.11+ - Modern Python release
- discord.py 2.0+ - Discord API wrapper
- Flask 3.0+ - Web framework
- Discord Bot Token - From Discord Developer Portal
Optional: OpenAI API (AI formatting), FlareSolverr (Rocket League), SMTP (email transcripts)
Contributions are welcome! See docs/CONTRIBUTING.md for guidelines.
Quick Steps:
- Fork the repository
- Create a feature branch (
git checkout -b feature/name) - Make changes (follow
ruffcode style) - Test thoroughly
- Submit a Pull Request
MIT License - see LICENSE for details. Free to fork, modify, and use!
Built with 💖 for The Chillventory community
- Powered by discord.py
- AI features by OpenAI GPT
- Special thanks to all contributors
Questions? Open an issue on GitHub or check the documentation!
Made with 💖 for The Chillventory 🌿