{"id":23673570,"url":"https://github.com/iamvikshan/amina","last_synced_at":"2026-04-02T22:14:56.436Z","repository":{"id":270173663,"uuid":"901727253","full_name":"iamvikshan/amina","owner":"iamvikshan","description":"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!","archived":false,"fork":false,"pushed_at":"2026-02-25T10:16:44.000Z","size":31851,"stargazers_count":6,"open_issues_count":5,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-25T10:47:10.722Z","etag":null,"topics":["chatbot","discord-bot","discord-js","discord-js-v14","gemini","google-ai","web-dashboard"],"latest_commit_sha":null,"homepage":"https://4mina.app/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc-by-4.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/iamvikshan.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"iamvikshan","ko_fi":"vikshan","patreon":"vikshan","liberapay":"vikshan","issuehunt":"iamvikshan"}},"created_at":"2024-12-11T07:48:48.000Z","updated_at":"2026-02-25T10:16:46.000Z","dependencies_parsed_at":"2025-12-06T10:00:36.662Z","dependency_job_id":null,"html_url":"https://github.com/iamvikshan/amina","commit_stats":null,"previous_names":["iamvikshan/amina"],"tags_count":28,"template":false,"template_full_name":null,"purl":"pkg:github/iamvikshan/amina","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamvikshan%2Famina","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamvikshan%2Famina/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamvikshan%2Famina/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamvikshan%2Famina/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iamvikshan","download_url":"https://codeload.github.com/iamvikshan/amina/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamvikshan%2Famina/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29929103,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-27T19:37:42.220Z","status":"online","status_checked_at":"2026-02-28T02:00:07.010Z","response_time":90,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chatbot","discord-bot","discord-js","discord-js-v14","gemini","google-ai","web-dashboard"],"created_at":"2024-12-29T12:29:39.117Z","updated_at":"2026-04-02T22:14:56.429Z","avatar_url":"https://github.com/iamvikshan.png","language":"TypeScript","funding_links":["https://github.com/sponsors/iamvikshan","https://ko-fi.com/vikshan","https://patreon.com/vikshan","https://liberapay.com/vikshan","https://issuehunt.io/r/iamvikshan"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\r\n  \u003cimg src=\"assets/logo/headshot-emoji.png\" alt=\"Amina - Your Guardian Companion\" width=\"200\" /\u003e\r\n  \r\n  \u003ch1\u003e AMINA \u003c/h1\u003e\r\n  \u003ch3\u003eYour Guardian Companion in the Digital Empire\u003c/h3\u003e\r\n\r\n[![Ko-fi](https://img.shields.io/badge/Support-Ko--fi-DC143C?style=for-the-badge\u0026logo=ko-fi\u0026logoColor=white)](https://ko-fi.com/vikshan)\r\n[![WakaTime](https://wakatime.com/badge/github/iamvikshan/amina.svg?style=for-the-badge)](https://wakatime.com/badge/github/iamvikshan/amina)\r\n\r\n[![Version](https://img.shields.io/github/package-json/v/iamvikshan/amina?style=for-the-badge\u0026logo=npm\u0026logoColor=white\u0026color=DC143C)](https://github.com/iamvikshan/amina)\r\n[![Contributors](https://img.shields.io/github/contributors/iamvikshan/amina.svg?style=for-the-badge\u0026logo=github\u0026color=1E90FF)](https://github.com/iamvikshan/amina/graphs/contributors)\r\n[![PRs](https://img.shields.io/github/issues-pr/iamvikshan/amina?style=for-the-badge\u0026logo=git\u0026color=FFD700)](https://github.com/iamvikshan/amina/pulls)\r\n[![Forks](https://img.shields.io/github/forks/iamvikshan/amina.svg?style=for-the-badge\u0026logo=github\u0026color=1E90FF)](https://github.com/iamvikshan/amina/network/members)\r\n[![Stars](https://img.shields.io/github/stars/iamvikshan/amina.svg?style=for-the-badge\u0026logo=github\u0026color=FFD700)](https://github.com/iamvikshan/amina/stargazers)\r\n[![Issues](https://img.shields.io/github/issues/iamvikshan/amina.svg?style=for-the-badge\u0026logo=github\u0026color=DC143C)](https://github.com/iamvikshan/amina/issues)\r\n[![License](https://img.shields.io/github/license/iamvikshan/amina.svg?style=for-the-badge\u0026logo=opensourceinitiative\u0026logoColor=white\u0026color=00CED1)](https://github.com/iamvikshan/amina/blob/main/LICENSE.md)\r\n\r\n  \u003cp align=\"center\"\u003e\r\n    \u003cstrong\u003e Protecting Communities • Creating Joy • Bringing People Together\u003c/strong\u003e\r\n  \u003c/p\u003e\r\n\r\n[⚡ Quick Deploy](#-mission-briefing-quick-deploy) • [🗡️ Arsenal](#-guardian-arsenal-features) •\r\n[📦 Installation](#-battle-preparation-installation) • [💬 Support](#-join-the-alliance) •\r\n[🤝 Contributing](#contributing) • [📚 Wiki](https://docs.4mina.app)\r\n\r\n\u003c/div\u003e\r\n\r\n---\r\n\r\n\u003e [!IMPORTANT]\r\n\u003e\r\n\u003e **ACTIVE DEVELOPMENT STATUS**  \r\n\u003e Amina is still being enhanced! Some defense systems and features may be under construction.\r\n\r\n## Who Am I?\r\n\r\nHey there! I'm **Amina** (**mina** preferably)— your guardian companion.\r\n\r\nUnlike 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.\r\n\r\nI'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.\r\n\r\n\u003e _\"Communities are everything. And protect them all i shall.\"_ — Amina\r\n\r\n## Quick Deploy\r\n\r\nReady to add me to your squad? Here's everything you need:\r\n\r\n- **[Recruit Amina](https://discord.com/api/oauth2/authorize?client_id=1035629678632915055\u0026scope=bot+applications.commands\u0026permissions=1374891928950)** — Add me to your server (Battle Preparation)\r\n- **[Documentation](https://docs.4mina.app)** — Full tactical manual\r\n- **[Support Server](https://discord.gg/uMgS9evnmv)** — Join the Alliance HQ\r\n- **[Buy Me a Coffee](https://ko-fi.com/vikshan)** — Support the Amina Project\r\n\r\n## Features\r\n\r\n### Defense Protocols (Moderation \u0026 Administration)\r\n\r\nI take protection seriously. Here's what's in my defense arsenal:\r\n\r\n- **Web Dashboard** — Full server configuration from a sleek web interface\r\n- **Automated Defense** — Anti-spam, anti-raid, invite filtering (set it and forget it)\r\n- **Moderation Tools** — Ban, kick, mute, warn — all the classics, but better\r\n- **Ticket System** — Custom ticket system for user support\r\n- **Rank Assignment** — Role management, auto-roles, and permission control\r\n\r\n### Morale Operations (Entertainment)\r\n\r\nProtection alone isn't enough. Communities need **life** and **energy**:\r\n\r\n- **High-Quality Audio** — Music playback from multiple sources (Spotify, YouTube, SoundCloud)\r\n- **Battle Mini-Games** — Fun commands to keep your community engaged\r\n- **Anime Reactions** — Express yourself with style (I've got taste!)\r\n- **Image Arsenal** — Manipulation tools for memes and creativity\r\n- **Economy System** — Custom currency and rewards for active members\r\n\r\n### Intelligence Reports (Utility)\r\n\r\nKnowledge is power. Stay informed:\r\n\r\n- **Server Analytics** — Detailed statistics and insights\r\n- **Invite Tracking** — See who's bringing new members\r\n- **Suggestion System** — Let your community voice their ideas\r\n- **Multi-Language Support** — Speak to everyone\r\n- **Weather Intel** — Real-time weather information\r\n- **Translation Services** — Break language barriers\r\n\r\n📖 **[Full Command Arsenal](https://docs.4mina.app)** — Every tool at your disposal\r\n\r\n## Project Structure\r\n\r\n```text\r\nsrc/           → Discord bot source code (discord.js)\r\napi/           → REST API server (Cloudflare Workers, Hono + MongoDB)\r\ntests/         → Test suite\r\ntypes/         → Bot TypeScript type definitions\r\nlavalink/      → Lavalink music server config\r\n```\r\n\r\n- **API docs \u0026 developer wiki** → [docs.4mina.app](https://docs.4mina.app)\r\n- **Dashboard** → [4mina.app/dash](https://4mina.app/dash)\r\n\r\n## Guardian Ranks\r\n\r\nAs you work with me, you'll advance through the Guardian Ranks:\r\n\r\n| Rank             | Servers | Status                      |\r\n| ---------------- | ------- | --------------------------- |\r\n| 🎖️ **Recruit**   | 0-1     | Just joined the Night Guard |\r\n| 🥉 **Scout**     | 2-4     | Skills developing nicely    |\r\n| 🥈 **Guard**     | 5-8     | Proven in battle            |\r\n| 🥇 **Elite**     | 9-13    | One of the best             |\r\n| 💎 **Commander** | 14-19   | Leading multiple fronts     |\r\n| 👑 **Legend**    | 20+     | Transcended the ranks       |\r\n\r\n_Track your rank (and secret achievements) in the [Command Center Dashboard](https://4mina.app/dash)_\r\n\r\n\u003e pst : Higher ranks unlock exclusive features and perks!\r\n\r\n## Installation\r\n\r\nWant to deploy me on your own infra? Respect. Here's how:\r\n\r\n```bash\r\nbunx amina install\r\n```\r\n\r\nsee full **[Self-Hosting Guide](https://docs.4mina.app/wiki/quick-start-self-hosting)** — Complete deployment instructions\r\n\r\n\u003e **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\u0026scope=bot+applications.commands\u0026permissions=1374891928950) — it's easier and always up-to-date!\r\n\r\n## 💬 Join the Alliance\r\n\r\nNeed backup? Have questions? Found a bug that needs eliminating?\r\n\r\n**Join the Support Server** — The Alliance HQ awaits you:\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n  \u003ca href=\"https://discord.gg/uMgS9evnmv\"\u003e\r\n    \u003cimg src=\"https://invidget.switchblade.xyz/uMgS9evnmv\" alt=\"Discord Server Invite\"\u003e\r\n  \u003c/a\u003e\r\n\u003c/div\u003e\r\n\r\nWe're a community of server owners, developers, and guardians helping each other out. Don't be shy — we've all been there!\r\n\r\n## Contributing\r\n\r\nWant to join the Night Guard development team? Hell yeah! Here's how:\r\n\r\n\u003e 📚 **Developer Guide:** Check out the [Wiki](https://docs.4mina.app) for architecture overviews and coding guides.\r\n\r\n1. **[Fork the Repository](https://github.com/iamvikshan/amina/fork)** — Make it yours\r\n2. **Create Your Feature Branch** — `git checkout -b feature/EpicNewFeature`\r\n3. **Commit Your Changes** — `git commit -m '⚔️ Add some EpicNewFeature'`\r\n4. **Push to Your Branch** — `git push origin feature/EpicNewFeature`\r\n5. **Open a Pull Request** — Show me what you've got!\r\n\r\n### 💡 Contribution Ideas:\r\n\r\n- **Bug Hunting** — Find and squash issues\r\n- **New Features** — Got an idea? Build it!\r\n- **Documentation** — Help others understand the system\r\n- **Design** — Make the dashboard even more badass\r\n- **Translations** — Help me speak more languages\r\n\r\nEvery contribution matters, no matter how small. Together, we make the Digital Empire safer!\r\n\r\n## Stats for the Night Guard\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n\r\n![Repobeats Analytics](https://repobeats.axiom.co/api/embed/33971866cc9f23ecadf447d38dbb129311693c2b.svg 'Repobeats analytics image')\r\n\r\n\u003c/div\u003e\r\n\r\n## 💪 Powered By Allies\r\n\r\nSpecial thanks to our infrastructure partners who keep the Night Guard operational:\r\n\r\n\u003cp align=\"center\"\u003e\r\n  \u003ca href=\"https://www.digitalocean.com/?refcode=c5587212fe39\u0026utm_campaign=Referral_Invite\u0026utm_medium=Referral_Program\u0026utm_source=badge\"\u003e\r\n    \u003cimg src=\"https://web-platforms.sfo2.cdn.digitaloceanspaces.com/WWW/Badge%201.svg\" alt=\"DigitalOcean\" height=\"50\"\u003e\r\n  \u003c/a\u003e\r\n  \u003ca href=\"https://go.vikshan.me/vultr\"\u003e\r\n    \u003cimg src=\"https://www.vultr.com/media/logo_ondark.svg\" alt=\"Vultr\" height=\"50\" width=\"100\"\u003e\r\n  \u003c/a\u003e\r\n  \u003ca href=\"https://partnernetwork.ionos.com/partner/vikshan?origin=PartnerBadge\"\u003e\r\n    \u003cimg src=\"https://images-2.partnerportal.ionos.com/items/0461b6bb-dabe-40bb-8d94-feb41be45e49/profiles/b6282cd9-10f6-4260-90dd-0bc4584f9c33/badges/normal_blue_eco\" alt=\"IONOS\" height=\"52\" width=\"108\"\u003e\r\n  \u003c/a\u003e\r\n\u003c/p\u003e\r\n\r\n---\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n\r\n### Built with Purpose, To Protect w/out Passion, for some reason.\r\n\r\n**[Recruit Amina Now](https://discord.com/api/oauth2/authorize?client_id=1035629678632915055\u0026scope=bot+applications.commands\u0026permissions=1374891928950)** • **[Documentation](https://docs.4mina.app)** • **[Support Server](https://discord.gg/uMgS9evnmv)**\r\n\r\n\u003csub\u003eForged by [vikshan](https://vikshan.me) with 🎶 and ☕ | Licensed under [ADL](./LICENSE)\u003c/sub\u003e\r\n\r\n\u003cimg src=\"https://capsule-render.vercel.app/api?type=waving\u0026color=DC143C\u0026height=100\u0026section=footer\" /\u003e\r\n\r\n\u003c/div\u003e\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiamvikshan%2Famina","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiamvikshan%2Famina","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiamvikshan%2Famina/lists"}