Skip to content
This repository was archived by the owner on Dec 8, 2025. It is now read-only.

AlphaGameBot/AlphaGameBot

Repository files navigation

AlphaGameBot

A free, open-source multipurpose bot that doesn't suck.

GitHub contributors GitHub License GitHub repo size Docker Pulls Docker Image Version

Made by a ENTP with love ❤️

Important

This repository (and the Python version of AlphaGameBot, 2.x and 3.x) is officially deprecated and is no longer being maintained. All work has been moved to the new version, along with the new website in a monorepo. It can be found here.
Please read the end of life letter on the website. Believe me, this project is not dead.

Check out AlphaGameBot's website!

What is AlphaGameBot?

AlphaGameBot is a free and open-source Discord bot. I got the inspiration to make AlphaGameBot when I was trying to find a good Discord bot that met my high requirements

  • 100% Free. No Premium version, no purchases, and commands locked behind paywalls, just a functional, cool Discord bot for which we don't have to pay a million bucks.
  • Open-Source. I am a strong supporter of Open-Source Software, and I would love for the Discord bot that I use to be open-source.
  • Good. No, seriously. As much as I love to see developers make their own small bots, they don't have all the commands we take for granted. Don't get me wrong-- Everyone should make their own Discord bots! I love seeing their ideas and bots to play around with. However, I wanted to make something that any server can use, enormous, big, medium, or small.

That led to the first version of AlphaGameBot. I am still working on it with nearly every possible moment that I can, (which is limited, sadly, as I am a high-school student) with the intent to make it the amazing bot that we all know it can be.

How can I add it to my server?

I'm so glad you asked! AlphaGameBot is available for anyone to add to their server. All required information can be found on AlphaGameBot's webpage here!

Can I contribute?

Of course! Any contribution, big or small, is very much welcome! Check out my requirements for commits here.

Run the bot

If you do not have a database for the bot, that's fine. Just use -n or --nodatabase to tell the bot that, and it'll take care of the rest..

Example: python main.py -n

Example configurations

python main.py -re .env - Run the bot WITH database enabled, and also load environment variables from a file called .env.

python main.py -drqe .env - Run bot in debug mode, but do not track message counts (for /user stats)

Docker :)

Prebuilt images are available on Docker Hub. More information can be found there.

Important

If you are sure you want to use the depricated python version, make sure to use either an explicit tag to which version (2.x to 3.x) or just use the py-latest tag. alphagamedev/alphagamebot:py-latest

QuickStart: docker run -d --restart unless-stopped --name some-alphagamebot -e TOKEN="..." alphagamedev/alphagamebot:latest /docker/main.py -nsq

Contributors

Languages