tarrotsimplified

Offline tarot readings as a Python library. All 78 cards with a Yes/No answer and personal guidance ship inside the package — no server, no API.

Install

pip install tarrotsimplified

Use

import tarrotsimplified as tw

# look up a card
c = tw.get_card("The Tower")
print(c.yes_no)      # "no"
print(c.guidance)

# yes/no question
r = tw.ask("Should I take the job?")
print(r["card"].name, "->", r["answer"])
print(r["guidance"])

# draw random cards
for c in tw.draw(3):
    print(c.name, "-", c.yes_no)

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

# search guidance text
print([c.name for c in tw.search("fertility")])

# whole suit
print([c.name for c in tw.by_suit("cups")])

Spreads: single, three_card, situation. Each Card has: name, arcana, suit, number, yes_no, guidance.

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.