tarot-card-meanings

A comprehensive Python library providing meanings, interpretations, and metadata for all 78 tarot cards. Includes upright, reversed, love, career, and yes/no interpretations for all Major and Minor Arcana cards.

By Deckaura -- Tarot decks, oracle cards, and free divination tools.

Also available for JavaScript/Node.js: npm install tarot-card-meanings

Installation

pip install tarot-card-meanings

Quick Start

from tarot_card_meanings import random_card, three_card_spread, birth_card

# Draw a random card
card = random_card()
print(f"{card['name']}: {card['upright']}")
print(f"Guide: {card['guide']}")

# 3-card spread (Past / Present / Future)
spread = three_card_spread()
print(f"Past: {spread['past']['name']}")
print(f"Present: {spread['present']['name']}")
print(f"Future: {spread['future']['name']}")

# Calculate your birth card
my_card = birth_card(6, 15, 1992)
print(f"Your birth card: {my_card['name']}")

Features

• All 78 tarot cards (22 Major Arcana + 56 Minor Arcana)
• Upright and reversed meanings
• Love and career interpretations
• Yes/No readings
• Zodiac and element associations
• Birth card calculator
• 3-card spread generator
• Links to detailed guides for each card on deckaura.com

API Reference

Card Data Structure

Each card contains:

{
    "number": 17,
    "name": "The Star",
    "arcana": "Major",
    "suit": None,
    "element": "Air",
    "upright": "Hope, renewal, spirituality",
    "reversed": "Despair, lack of faith",
    "love": "Healing love, renewed hope",
    "career": "Creative inspiration, dream career",
    "yes_no": "Yes",
    "zodiac": "Aquarius",
    "guide": "https://deckaura.com/blogs/guide/star-tarot-meaning"
}

Use Cases

• Tarot apps -- Build mobile or web tarot reading applications
• Data analysis -- Explore tarot card distributions on Kaggle
• Machine learning -- Train models using tarot card data on HuggingFace
• Chatbots -- Power tarot readings in Discord bots, Slack apps, or Alexa skills
• Content generation -- Create tarot-related content programmatically

Free Online Tools

Try the live interactive versions of this library:

• Free Tarot Reading -- Interactive 3-card and Celtic Cross spreads
• Free Yes or No Tarot -- Instant yes/no answers
• Tarot Birth Card Calculator -- Find your Major Arcana life card
• Numerology Calculator -- Calculate your life path number
• Daily Tarot Card -- Draw a card for daily guidance
• Spirit Animal Quiz -- Discover your spirit animal
• Angel Number Calculator -- Decode angel numbers
• Daily Horoscope -- Personalized daily horoscopes

Part of the Deckaura Ecosystem

Deckaura (Wikidata Q138745960) is a unified tarot and divination platform. This PyPI package is one component of the broader ecosystem:

License

MIT -- Deckaura