💎 Terra - Python Discord Bot 💎

Shortcuts

• About

• Features

• Planned Features

• Contributing

• Support

• Requirements

• How To Migrate (Update) DB

---

👋 About

Terra is growing open-source Discord bot that have some useful stuff.
We aiming to implement as many useful bot functionality as we can.

Note: This project was created mainly for our portfolio, so please do not create pool requests, sorry. Please check out our Contributing section for more information.

If you want to try it out by yourself, you can invite it to your Discord server by clicking Here!

---

🌟 Features

Commands syntax: command <required> [optional]

General commands

help - Shows help message. If command name is specified, shows help message for that command.
    Syntax: help [Command Name]

User's commands

profile - Shows user's profile.
    Syntax: profile [Server Member]

Fun commands

8ball - Ask the magic 8 ball a question.
    Syntax: 8ball <Question>
    Aliases: 8b, magic8ball, magic8b

coinflip - Flip a coin and guess which side (heads or tails) it will land on.
    Syntax: coinflip <Coin Side>

Util commands

first-message - Shows first message in channel.
    Syntax: first-message
    Aliases: firstmsg, fmsg

---

📅 Planned Features

You can find current updates plan in TODO.md file!

---

🤝 Contributing

As it was described in About section, this project was created mainly for our portfolio, so please do not create pool requests, sorry.

But your ideas, suggestions and bug reports are welcome! Feel free to check out our issues page to find out what you could do!

---

💖 Support

You can support us by:

• Joining to our discord Support Server.

• Adding our bot to your server (Click here).

• Starring this repository.

---

📜 Requirements

These are the requirements for the bot.

• Python 3.10 (Required packages listed in requirements.txt)

• Set environment variable DISCORD_BOT_TOKEN with your bot token OR replace "YOUR_TOKEN_HERE" in config.py with your bot token (keep quotes).

---

🧾 How To Migrate (Update) DB

What is migration?
Migration is a way to update database structure without losing data.
In this project we are using Aerich to manage migrations.

Note: All migrations are stored in migrations folder.

To migrate database, you need to do the following steps:

1. Be sure that you have installed all required packages from requirements.txt

2. Run these commands:

   >>> aerich migrate --name YOUR_MIGRATION_NAME
   >>> aerich upgrade