Short description: A lightweight, extensible Discord bot built by im-amal-raj — open source and actively developed. Ideal for moderation, utilities, and customizable plugins. Keywords: Discord bot, discord.js, discord.py, Node.js, Python, moderation bot, open-source.
Status: 🚧 Under Construction — modular design, clear contributor-friendly structure, and documentation coming soon.
Special note: This repo is maintained by im-amal-raj. For more about the maintainer (tech stack, location, contact links, portfolio), see the profile README: https://github.com/im-amal-raj. Personal highlights included below to help collaborators learn who you’ll be working with.
This repository will host a production-ready, modular Discord bot with a focus on:
- Clean command/plugin architecture
- Permission-safe moderation commands
- Optional music and utility modules
- Easy local development and deployment
- Tests and CI in later stages
Maintainer snapshot
- Name / Handle: im-amal-raj (Kerala, India)
- Open to: Freelance, internships, entry-level work
- Personal sites: https://im-amal-raj.github.io/
- LinkedIn: https://www.linkedin.com/in/im-amal-raj/
- Email: amalMraj@proton.me
- Primary interests & tech: Python, JavaScript, HTML, CSS, Django, React, discord.py, discord.js, SQLite
- Core: command loader, help system, prefix & slash command support
- Moderation: ban, kick, mute, warnings, mod-logs
- Utilities: ping, server-info, user-info, custom commands
- Persistence: SQLite (or optional MongoDB)
- Optional: Music module (if maintainable with API changes)
- Developer: modular plugin API for third-party commands
- Node.js (recommended LTS) + discord.js OR Python + discord.py (owner preference)
- dotenv for config
- Optional DB: SQLite / MongoDB / Prisma
- Test runner & CI: Jest / GitHub Actions (planned)
- Clone git clone https://github.com/im-amal-raj/discord-bot.git
- Enter cd discord-bot
- Install npm install
- Create .env (example) DISCORD_TOKEN=your-discord-bot-token BOT_PREFIX=! NODE_ENV=development
- Run npm run dev
(If this repo uses Python, use venv, pip install -r requirements.txt, and run python bot.py — exact commands will be added once code scaffolding is present.)
- NEVER commit your .env or tokens. Use environment variables or secret managers.
- Keep bot intents minimal and request only the permissions you need.
- Use role-based permission checks for moderation commands.
Contributions are welcome! Please help by starring and forking the repo, then open a pull request.
How to contribute (quick):
- Star ⭐ the repository
- Fork the repository
- Create a feature branch git checkout -b feat/your-feature
- Add code, tests, and documentation
- Commit and push, then open a Pull Request against main
Pull request checklist:
- Code builds and runs locally
- Security-sensitive data not included
- Tests added/updated (if applicable)
- README/Docs updated
- Clear PR description for reviewers
This project will use the MIT License — a permissive, widely used open-source license. Include a LICENSE file (MIT) in the repository.
Maintainer: im-amal-raj — https://github.com/im-amal-raj
Report issues: https://github.com/im-amal-raj/discord-bot/issues
Portfolio: https://im-amal-raj.github.io/
LinkedIn: https://www.linkedin.com/in/im-amal-raj/
Email: amalMraj@proton.me
discord bot, discord.js, discord.py, Node.js discord bot, Python discord bot, moderation bot, music bot, open-source Discord bot, command framework, im-amal-raj
Thanks to the Discord API and the maintainers of discord.js / discord.py. This repository is intentionally minimal while under construction — more docs, examples and CI will be added soon.