Metadata-Version: 2.4
Name: tarotoo-tarot
Version: 1.7.1
Summary: All 78 tarot card meanings (Rider-Waite-Smith) as structured data with lookup helpers - the open Tarotoo dataset
Project-URL: Homepage, https://tarotoo.com/card-meanings-dataset
Project-URL: Repository, https://github.com/Tarotoo-com/tarotoo-tarot-dataset
Project-URL: Issues, https://github.com/Tarotoo-com/tarotoo-tarot-dataset/issues
Project-URL: Hugging Face, https://huggingface.co/datasets/Tarotoo/tarotoo-tarot-card-meanings
Project-URL: DOI, https://doi.org/10.5281/zenodo.21268290
Author: Tarotoo
License-Expression: MIT
Keywords: card-meanings,dataset,divination,rider-waite-smith,tarot,tarot-cards
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# tarotoo-tarot

All **78 tarot card meanings** (Rider–Waite–Smith tradition) as structured data with lookup helpers. This is the open [Tarotoo tarot dataset](https://github.com/Tarotoo-com/tarotoo-tarot-dataset) — the same card meanings that ground the AI readings on [Tarotoo.com](https://tarotoo.com).

```bash
pip install tarotoo-tarot
```

## Usage

```python
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`, `keywords_upright`, `keywords_reversed`, `meaning_upright`, `meaning_reversed`, `love`, `career`, `mood`, `spiritual`, `url`.

## Related

- Dataset source: [github.com/Tarotoo-com/tarotoo-tarot-dataset](https://github.com/Tarotoo-com/tarotoo-tarot-dataset)
- MCP server for AI assistants: [github.com/Tarotoo-com/tarotoo-mcp-server](https://github.com/Tarotoo-com/tarotoo-mcp-server)
- npm package: `npm install tarotoo-tarot`

## License

Data and code released under the MIT License. Attribution to Tarotoo (tarotoo.com) is appreciated. For entertainment and self-reflection purposes only — not medical, legal, financial, or mental-health advice.
