Mage Tarot Bot is a Discord bot built around an original fantasy-themed tarot card deck. The cards are custom-designed artwork across 5 unique suits — Major Arcana, Dynamism, Pattern, Primordialism, and Questing — totaling ~78 unique cards.
The bot runs two slash commands:
/tarot— draws 1, 3, or 5 random cards from the full deck/tarot_suit— draws a single card from a chosen suit
Each card is sent as a Discord embed with its artwork and a short Turkish description (currently complete for Major Arcana).
The deck replaces traditional tarot suit names (Wands, Cups, Swords, Pentacles) with original fantasy equivalents, while keeping the standard 14-card minor arcana structure (Ace through 10, Page, Knight, King, Queen). Major Arcana follows the classic 22-card sequence with renamed cards such as "Gaia" instead of The World and "Luna" instead of The Moon.
| Suit | Cards |
|---|---|
| Major Arcana 🌟 | 22 |
| Dynamism ⚡ | 14 |
| Pattern 🔷 | 14 |
| Primordialism 🌿 | 14 |
| Questing ⚔️ | 14 |
Built with Python using discord.py and Pillow. Card artwork is stored as .tif originals and converted to PNG on the fly before being sent to Discord. A web_cards/ folder containing pre-converted PNGs is also included, ready for static web use.
discord.py>=2.3.0
Pillow>=10.0.0
python-dotenv>=1.0.0
- Clone the repository
- Install dependencies:
pip install -r requirements.txt - Create a
.envfile and add your Discord bot token:DISCORD_TOKEN=your_token_here - Run the bot:
python bot.py