Skip to content

NovatraX/NovatraBot

Repository files navigation

🚀 NovatraBot

Python Discord.py License Issues Pull Requests

A powerful Discord bot designed to enhance community management and personal accountability. Built with Python and powered by cutting-edge AI for moderation and user engagement.

✨ Features

🤖 Core Functionality

  • Ping & Uptime Monitoring: Check bot latency and operational status
  • Bot Information: Get detailed info about the bot and its capabilities
  • Developer Tools: Access to special assets and commands

🛡️ Moderation System

  • Automatic Profanity Detection: Real-time content filtering using advanced AI
  • Warning System: Tracks user violations with persistent database storage
  • Smart Moderation: Intelligent scoring system for content severity

📊 Accountability Tracker

  • Daily Task Logging: Log and track personal goals and achievements
  • Statistics Dashboard: View personal and community progress
  • Leaderboard System: Competitive ranking for motivation
  • History Tracking: Comprehensive activity logs
  • Automated Reminders: Stay on track with scheduled notifications

🎯 Additional Features

  • Interactive Help System: Comprehensive command guidance
  • Feedback Collection: User feedback integration
  • Status Monitoring: Real-time bot health checks
  • Reaction Handling: Custom reaction management

🛠️ Installation

Prerequisites

Setup

  1. Clone the repository

    git clone https://github.com/NovatraX/NovatraBot.git
    cd NovatraBot
  2. Install dependencies

    pip install -r requirements.txt

    Or if using uv

    uv sync
  3. Environment Configuration

    cp .env.example .env

    Edit .env and add your Discord bot token:

    TOKEN=your_discord_bot_token_here
  4. Run the bot

    python bot.py

    Or if using uv

    uv run bot.py

📖 Usage

Basic Commands

  • /ping - Check bot latency and uptime
  • /info - Get bot information
  • /help - Interactive help system

Accountability Commands

  • /log add <task> - Log a daily task
  • /log delete <task_number> - Remove a logged task
  • /log stats [user] - View accountability statistics
  • /log history - Check your activity history
  • /log leaderboard - See community rankings

Moderation

The bot automatically monitors messages for inappropriate content and handles warnings internally. Moderators can review logs in designated channels.

🔧 Configuration

Database Setup

The bot uses SQLite databases for data persistence:

  • moderation.db - Stores warning data and user violations
  • accountability.db - Tracks user tasks and progress

Permissions

Ensure your bot has the following permissions:

  • Read Messages
  • Send Messages
  • Embed Links
  • Delete Messages
  • Read Message History
  • Mention Everyone (optional)

🤝 Contributing

We welcome contributions! Here's how you can help:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

📞 Support


Made wWth ❤️ By Novatra

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •  

Languages