tarot-card-meanings 1.0.1

Complete 78 tarot card meanings database with upright, reversed, love, career, and yes/no interpretations. Part of the Deckaura Ecosystem.

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

Function	Description
get_all_cards()	Return all 78 cards
get_card(name)	Get a specific card by name
get_major_arcana()	Return 22 Major Arcana cards
get_minor_arcana()	Return 56 Minor Arcana cards
get_suit(suit)	Get cards by suit (Wands, Cups, Swords, Pentacles)
random_card()	Draw a random card
three_card_spread()	Draw a Past/Present/Future spread
yes_no_reading()	Draw a card for yes/no answer
birth_card(month, day, year)	Calculate tarot birth card from birthday

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:

Platform	Link
Official Website	deckaura.com
Wikidata Entity	Q138745960
GitHub Repository	gokimedia/tarot-card-meanings
NPM Package	tarot-card-meanings
GitHub Pages Tool	Free Yes/No Tarot Reading
YouTube	@deckaura
Reddit	r/TarotvsOracle
Kaggle	morrispoint
HuggingFace	Blacik
Linktree	deckauraa
Dev.to	birdircik
Quora	Tarot Oracle Card Guide
Daily Horoscope	horoscope.deckaura.com
Chrome Extension	Daily Tarot Card (Chrome Web Store)

License

MIT -- Deckaura