tarrotsimplified

Offline tarot card interpretations as a Python library. No server, no API — the card data ships inside the package.

Status: early release. Only a handful of sample cards are included so far (The Fool, The Magician, Ace of Cups, Two of Wands) — the full 78-card deck is coming in a follow-up release.

Install

pip install tarrotsimplified

Use

import tarrotsimplified as tw

# look up a card
card = tw.get_card("The Fool")
print(card.upright)
print(card.keywords)

# draw random cards (some may be reversed)
for item in tw.draw(3):
    c = item["card"]
    print(c.name, "(reversed)" if item["reversed"] else "", "-", c.meaning(item["reversed"]))

# do a named spread
for item in tw.spread("three_card"):
    print(item["position"], "->", item["card"].name)

# search meanings
print([c.name for c in tw.search("new beginnings")])

Spreads available: single, three_card, celtic_cross.

Publish to PyPI (one time)

pip install build twine
python -m build          # creates dist/*.whl and *.tar.gz
twine upload dist/*      # asks for your PyPI token

After that, anyone can pip install tarrotsimplified. Bump version in pyproject.toml and __init__.py for each new release.