EchoX 🤖

EchoX is a versatile Discord Bot built with discord.py. It aims to provide essential moderation tools, AI-powered interactions, and an intuitive help system to enhance your server experience.

---

✨ Features

• 🤖 AI Integration – Engage with AI-powered chat features.
• 🛡️ Moderation Commands – Keep your server safe with kick, ban, mute, clear, lockdown, and slowmode commands.
• ❓ Dynamic Help Cog – Easily discover all commands with an organized help menu.
• ⚙️ Modular Cog Structure – Clean and scalable code with separate cogs for different functionalities.
• 📁 Utility Tools – Extra utility commands for everyday server management.

---

📋 Prerequisites

Before you begin, ensure you have the following:

• Python 3.8 or higher installed on your system.
• A Discord Bot Token. Get one from the Discord Developer Portal.
• Your bot invited to a server with the necessary permissions:
  • Send Messages
  • Manage Messages
  • Kick Members
  • Ban Members
  • Use Slash Commands

---

🚀 Installation & Setup

Follow these steps to get EchoX running:

1️⃣ Clone the Repository

git clone https://github.com/CodeWithMSami/EchoX.git
cd EchoX

2️⃣ Create a Virtual Environment (Recommended)

Windows

python -m venv venv
venv\Scripts\activate

Linux / macOS

python3 -m venv venv
source venv/bin/activate

3️⃣ Install Dependencies

pip install -r requirements.txt

4️⃣ Configure Environment Variables

Create a .env file in the root directory and add:

DISCOR_BOT_TOKEN=your-discord-bot-token
OPEN_ROUTER_API=your-open-router-api-key
OPEN_ROUTER_MODEL=your-open-router-model

5️⃣ Run the Bot

python app.py

---

📁 Project Structure

EchoX/
├── app.py                 # Main bot entry point
├── requirements.txt       # Python dependencies
├── .env                   # Environment variables
├── .gitignore
├── README.md
├── cogs/                  # Modular command categories
│   ├── help.py
│   ├── moderation.py
│   ├── ai.py
└── utils/                 # Helper functions and utilities
    ├── database.py
    ├── embeds.py
    └── envs.py

---

🛠️ Example Commands

Command	Description
!help	Displays all available commands
!kick	Kicks a member from the server
!ban	Bans a member
!mute	Mutes a member
!clear	Clears messages in a channel
!ai	Chat with the AI system

---

🤝 Contributing

Contributions are welcome!

Feel free to:

1. Fork the repository
2. Create a new branch
3. Make your changes
4. Submit a pull request

For major changes, please open an issue first to discuss what you would like to change.

---

📄 License

This project is currently not under a specific open-source license.

All rights are reserved by the author CodeWithMSami.

---

🙏 Acknowledgements

• – The powerful API wrapper for Discord.
• All contributors and users of EchoX.

---

🌟 Support

If you like this project, consider giving it a ⭐ on GitHub!

Made with ❤️ by CodeWithMSami