https://github.com/iamvikshan/amina
A Discord bot that actually talks back! Amina is a multipurpose Discord bot packed with moderation, engagement, web-dashboard and real conversation, in both dms and servers. Your server has never been better!
https://github.com/iamvikshan/amina
chatbot discord-bot discord-js discord-js-v14 gemini google-ai web-dashboard
Last synced: 3 months ago
JSON representation
A Discord bot that actually talks back! Amina is a multipurpose Discord bot packed with moderation, engagement, web-dashboard and real conversation, in both dms and servers. Your server has never been better!
- Host: GitHub
- URL: https://github.com/iamvikshan/amina
- Owner: iamvikshan
- License: cc-by-4.0
- Created: 2024-12-11T07:48:48.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-02-25T10:16:44.000Z (4 months ago)
- Last Synced: 2026-02-25T10:47:10.722Z (4 months ago)
- Topics: chatbot, discord-bot, discord-js, discord-js-v14, gemini, google-ai, web-dashboard
- Language: TypeScript
- Homepage: https://4mina.app/
- Size: 30.4 MB
- Stars: 6
- Watchers: 1
- Forks: 2
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
AMINA
Your Guardian Companion in the Digital Empire
[](https://ko-fi.com/vikshan)
[](https://wakatime.com/badge/github/iamvikshan/amina)
[](https://github.com/iamvikshan/amina)
[](https://github.com/iamvikshan/amina/graphs/contributors)
[](https://github.com/iamvikshan/amina/pulls)
[](https://github.com/iamvikshan/amina/network/members)
[](https://github.com/iamvikshan/amina/stargazers)
[](https://github.com/iamvikshan/amina/issues)
[](https://github.com/iamvikshan/amina/blob/main/LICENSE.md)
Protecting Communities • Creating Joy • Bringing People Together
[⚡ Quick Deploy](#-mission-briefing-quick-deploy) • [🗡️ Arsenal](#-guardian-arsenal-features) •
[📦 Installation](#-battle-preparation-installation) • [💬 Support](#-join-the-alliance) •
[🤝 Contributing](#contributing) • [📚 Wiki](https://docs.4mina.app)
---
> [!IMPORTANT]
>
> **ACTIVE DEVELOPMENT STATUS**
> Amina is still being enhanced! Some defense systems and features may be under construction.
## Who Am I?
Hey there! I'm **Amina** (**mina** preferably)— your guardian companion.
Unlike those cold, emotionless bots, I was given something special: **a heart**. I don't just moderate servers; I **protect communities** and help them thrive. Think of me as your right hand in battle — someone who'll stand beside you, fight alongside you, and celebrate your victories, even the littlest.
I'm dedicated to defending communities from spam, toxicity, and chaos. But the thing is: _a_ server without protection is vulnerable, but a server without joy is already dead.\* That's why I bring **both** to the table.
> _"Communities are everything. And protect them all i shall."_ — Amina
## Quick Deploy
Ready to add me to your squad? Here's everything you need:
- **[Recruit Amina](https://discord.com/api/oauth2/authorize?client_id=1035629678632915055&scope=bot+applications.commands&permissions=1374891928950)** — Add me to your server (Battle Preparation)
- **[Documentation](https://docs.4mina.app)** — Full tactical manual
- **[Support Server](https://discord.gg/uMgS9evnmv)** — Join the Alliance HQ
- **[Buy Me a Coffee](https://ko-fi.com/vikshan)** — Support the Amina Project
## Features
### Defense Protocols (Moderation & Administration)
I take protection seriously. Here's what's in my defense arsenal:
- **Web Dashboard** — Full server configuration from a sleek web interface
- **Automated Defense** — Anti-spam, anti-raid, invite filtering (set it and forget it)
- **Moderation Tools** — Ban, kick, mute, warn — all the classics, but better
- **Ticket System** — Custom ticket system for user support
- **Rank Assignment** — Role management, auto-roles, and permission control
### Morale Operations (Entertainment)
Protection alone isn't enough. Communities need **life** and **energy**:
- **High-Quality Audio** — Music playback from multiple sources (Spotify, YouTube, SoundCloud)
- **Battle Mini-Games** — Fun commands to keep your community engaged
- **Anime Reactions** — Express yourself with style (I've got taste!)
- **Image Arsenal** — Manipulation tools for memes and creativity
- **Economy System** — Custom currency and rewards for active members
### Intelligence Reports (Utility)
Knowledge is power. Stay informed:
- **Server Analytics** — Detailed statistics and insights
- **Invite Tracking** — See who's bringing new members
- **Suggestion System** — Let your community voice their ideas
- **Multi-Language Support** — Speak to everyone
- **Weather Intel** — Real-time weather information
- **Translation Services** — Break language barriers
📖 **[Full Command Arsenal](https://docs.4mina.app)** — Every tool at your disposal
## Project Structure
```text
src/ → Discord bot source code (discord.js)
api/ → REST API server (Cloudflare Workers, Hono + MongoDB)
tests/ → Test suite
types/ → Bot TypeScript type definitions
lavalink/ → Lavalink music server config
```
- **API docs & developer wiki** → [docs.4mina.app](https://docs.4mina.app)
- **Dashboard** → [4mina.app/dash](https://4mina.app/dash)
## Guardian Ranks
As you work with me, you'll advance through the Guardian Ranks:
| Rank | Servers | Status |
| ---------------- | ------- | --------------------------- |
| 🎖️ **Recruit** | 0-1 | Just joined the Night Guard |
| 🥉 **Scout** | 2-4 | Skills developing nicely |
| 🥈 **Guard** | 5-8 | Proven in battle |
| 🥇 **Elite** | 9-13 | One of the best |
| 💎 **Commander** | 14-19 | Leading multiple fronts |
| 👑 **Legend** | 20+ | Transcended the ranks |
_Track your rank (and secret achievements) in the [Command Center Dashboard](https://4mina.app/dash)_
> pst : Higher ranks unlock exclusive features and perks!
## Installation
Want to deploy me on your own infra? Respect. Here's how:
```bash
bunx amina install
```
see full **[Self-Hosting Guide](https://docs.4mina.app/wiki/quick-start-self-hosting)** — Complete deployment instructions
> **Note:** Self-hosting requires technical knowledge. For most users, I recommend using the [official hosted version](https://discord.com/api/oauth2/authorize?client_id=1035629678632915055&scope=bot+applications.commands&permissions=1374891928950) — it's easier and always up-to-date!
## 💬 Join the Alliance
Need backup? Have questions? Found a bug that needs eliminating?
**Join the Support Server** — The Alliance HQ awaits you:
We're a community of server owners, developers, and guardians helping each other out. Don't be shy — we've all been there!
## Contributing
Want to join the Night Guard development team? Hell yeah! Here's how:
> 📚 **Developer Guide:** Check out the [Wiki](https://docs.4mina.app) for architecture overviews and coding guides.
1. **[Fork the Repository](https://github.com/iamvikshan/amina/fork)** — Make it yours
2. **Create Your Feature Branch** — `git checkout -b feature/EpicNewFeature`
3. **Commit Your Changes** — `git commit -m '⚔️ Add some EpicNewFeature'`
4. **Push to Your Branch** — `git push origin feature/EpicNewFeature`
5. **Open a Pull Request** — Show me what you've got!
### 💡 Contribution Ideas:
- **Bug Hunting** — Find and squash issues
- **New Features** — Got an idea? Build it!
- **Documentation** — Help others understand the system
- **Design** — Make the dashboard even more badass
- **Translations** — Help me speak more languages
Every contribution matters, no matter how small. Together, we make the Digital Empire safer!
## Stats for the Night Guard
## 💪 Powered By Allies
Special thanks to our infrastructure partners who keep the Night Guard operational:
---
### Built with Purpose, To Protect w/out Passion, for some reason.
**[Recruit Amina Now](https://discord.com/api/oauth2/authorize?client_id=1035629678632915055&scope=bot+applications.commands&permissions=1374891928950)** • **[Documentation](https://docs.4mina.app)** • **[Support Server](https://discord.gg/uMgS9evnmv)**
Forged by [vikshan](https://vikshan.me) with 🎶 and ☕ | Licensed under [ADL](./LICENSE)
