tarotoo-tarot
All 78 tarot card meanings (Rider–Waite–Smith tradition) as structured data with lookup helpers. This is the open Tarotoo tarot dataset — the same card meanings that ground the AI readings on Tarotoo.com.
pip install tarotoo-tarot
Usage
from tarotoo_tarot import cards, get_card, list_cards, search_cards, yes_no
len(cards) # 78
get_card("The Fool")["meaning_upright"] # "New beginnings, spontaneity, innocence..."
get_card("fool")["yes_no"] # "maybe" (name matching is forgiving)
list_cards(suit="cups") # ["Ace of Cups", ..., "King of Cups"]
search_cards("heartbreak", limit=3) # [Three of Swords, ...]
yes_no("The Sun") # "yes"
Each card has: id, name, arcana, suit, number_numerology, element, planet, zodiac, yes_no, yes_no_reversed, keywords_upright, keywords_reversed, meaning_upright, meaning_reversed, love, love_reversed, career, career_reversed, mood, mood_reversed, spiritual, spiritual_reversed.
Links
| Resource | Link |
|---|---|
| Dataset source and docs | Tarotoo-com/tarotoo-tarot-dataset |
| Dataset homepage | tarotoo.com/open-data |
| npm package | tarotoo-tarot |
| MCP server for AI assistants | tarotoo-mcp-server |
| Hugging Face | Tarotoo/tarotoo-tarot-card-meanings |
| Kaggle | tarotoo/tarotoo-tarot-card-meanings |
| Citable DOI | 10.5281/zenodo.21285777 |
License
Data and code released under the MIT License. Attribution to Tarotoo (tarotoo.com) is appreciated. This dataset is intended for educational, research, creative, entertainment, and self-reflection purposes. It should not be used as a substitute for medical, legal, financial, mental-health, or other professional advice.
1 maintainer
Metadata
1 maintainer
Release files for tarotoo-tarot 2.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| tarotoo_tarot-2.0.1.tar.gz | 26.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| tarotoo_tarot-2.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 53.5 kB
Release files / tarotoo_tarot-2.0.1.tar.gz
| Download URL | tarotoo_tarot-2.0.1.tar.gz |
|---|---|
| Size | 26.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
bb3e06cb71377be0bcfb90f5c915b8bcce9dff23b8351b6c7de51f3e88764f84
|
|
BLAKE2b-256 checksum How to use checksums |
8bd8483a664b78a2afc7d4b6fb8065354908a7478c0aac1c7a7eb94c505022ed
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.5
|
Release files / tarotoo_tarot-2.0.1-py3-none-any.whl
| Download URL | tarotoo_tarot-2.0.1-py3-none-any.whl |
|---|---|
| Size | 26.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
31eb1c7924dc1b33b00c38a51baad19838e2c2092c707ddd0b26b93888b28ca3
|
|
BLAKE2b-256 checksum How to use checksums |
558b6f2ed0da88e90e8bbe71f3065b521c615a62cbca81c2b9df7b78acd7fc0d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.5
|
