🤖 Beshoo Bot

Beshoo is a multi-purpouse discord bot built with discord.py

The goal of the bot was simply to learn more about how to work with requests, APIs and python in general.

Features

• Fully modular
  • Easily remove/add any command by deleting/creating the cog or the command from run.py
• Admin commands like kick, ban and mute.
• Voice channel commands to play any youtube video.
• AI-powered image utilities like bgremove and face that work on any picture.
• fun commands like meme, quote, dog, cat and many more!
• Utility commands like weather, def.

Usage

to invite the bot to your server use the button below

Installation

Want to make the bot your own? follow these steps

Locally

requirments: Python 3.7+

Simply:

git clone https://github.com/M7mdisk/beshoo-bot.git
cd beshoo-bot

install the dependencies

pip install -r requirments.txt

or if you want to use a virtual environment

pipenv install

Rename the .env.example file to .env and replace the Xs by your tokens.

Finally, run the bot.

python3 run.py

and you're good to go!

Heroku

• coming soon.

Commands

• !help [command] Displays the help message. ¯_(ツ)_/¯.

Image proccessing

• !face Detect faces in the picture and give further info about them .
• !bgremove Remove Background from image!

Random

• !meme Generate Random memes..
• !def <word> Defines any word you type..
• !advice Generate random lief advice.
• !echo [args...] Reapeat whatever you type after !echo.
• !annoy [user] [num=10] Annoy Whoever you mention, ecept the Ebic owner of the bot.
• !server Display basic server info.
• ![weather|طقس] <city> [lang=en] Shows the weather of the Country you entered.
• !ping Check the bot's ping.
• !avatar [avamember] Show the users Avatar.
• !slap [members]... [reason=no reason] Slap any user you want to punish :3.
• !cat Generate random cat images/gif.
• !dog Generate random dog images/gif.

Tic Tac Toe

• !tictactoe <p1> <p2> Starts a game between two users.
• !place <pos> Place a mark on the playing table.
• !endgame End the game before it finishs.

Voice

• !join Join the voice channel.
• !play <url> Download the URL and play the music.
• !leave Leave the voice channel.

Admin

• !kick [user] [reason] Kick user.
• !ban [user] [reason] ban user.
• !mute [user] [time] mute user for a period of time.
• !clear [amount=10] Clear number of messages in a channel.
• !dm <@user> [content] Sends a message to a user in his DMs through the bot

Contributions

Please feel free to do a PR and we would be happy to check it out! there is no template but prefereably you should add the command to the correct cog or create a new one if it fits