OOTKThoth engine

Method and limits

How a reading is made, what it can't do, and what it is for.

What it is for

This site is a calculator and a prompt writer. It draws tarot cards, looks up their traditional correspondences, scores how they interact, and writes all of that up as a prompt. It does not interpret the cards itself. Your AI does that, from the prompt.

It is meant for studying the Thoth deck and its correspondences, for reflection, and for giving an AI the same careful groundwork every time instead of a bare list of card names.

It is not meant for decisions about health, money, law or safety, and it does not predict the future. Treat any reading, and anything an AI says about it, as something to think with rather than advice.

How a reading is made

  1. Shuffle. Your seed is turned into a number (SHA-256) that shuffles the 78 cards with Python’s standard shuffler. The same seed always gives the same order, which is what lets you repeat or share a reading. A blank seed gets a random six-digit number. The shuffle is ordinary software: nothing outside the seed chooses the cards.
  2. Draw. Cards are dealt from the top into the spread’s positions. For the 15-card heap and the full Opening of the Key, your significator is placed first. The full Opening of the Key reshuffles the whole deck for each operation, as the Golden Dawn method does, so a card (your significator too) can fall again in a house, sign or decan.
  3. Look up. Each card’s attribution, Hebrew letter or Sephira, path and King Scale colour come from Liber 777 tables, under the mapping system you chose (Thoth by default).
  4. Score. Neighbouring cards get a Book T elemental dignity. Neighbours are the next card along; in the 15-card heap they are the named pairs, and on the Tree of Life the Sephiroth a path joins:
    ElementsScore
    Same element+2
    Friendly (for example Fire and Air)+1
    Contrary (Fire and Water, Air and Earth)−2
    Spirit on either side0
    Cards are also related by where they sit in the layout; on the wheels of houses, signs and decans that means astrological aspects, counted within set orbs. These aspects belong to the layout, so they are the same in every reading of a spread; only the cards at their two ends change. The report adds the elemental balance, where the cards fall on the Cube of Space, and their Platonic solids.
  5. Choose a lens. On Auto, the macro framework comes from whether the cards run down the Tree of Life towards Malkuth or up towards Kether. The report says which, and why.
  6. Write the prompt. Sections 1 to 6 hold the cards and every calculation. Section 7 asks your AI to synthesise them and to describe tendencies and tensions rather than a fixed outcome, leaving the conclusion to you.

The code, tables and tests are all open source, so every step above can be checked.

Letters and solids in space

Rather than treating the Hebrew alphabet as an abstract list or the Platonic solids as isolated geometry, the report places both in three-dimensional space with two models: the Cube of Space from the Sefer Yetzirah, and polyhedral dual inversions.

Card maps draws both models and marks where any card sits on them.

Limitations

About the card art

The readings use the Thoth deck of Aleister Crowley and Lady Frieda Harris (painted 1938–43). Harris’s paintings are still under copyright, so each card is shown with its counterpart from the Rider-Waite-Smith deck, drawn by Pamela Colman Smith for A. E. Waite in 1909 and now in the public domain. Both decks come from the Golden Dawn’s system, so every Thoth card has a Waite counterpart, though many go by a different name.

Each picture keeps the name Waite printed on it, as a check on the Thoth title above it. Waite printed no names on the numbered cards (2 to 10), so this site adds a banner with the Thoth title there. Where the names differ, the card also says which Waite card is pictured, for example “Pictured: Rider-Waite-Smith King of Wands”.

Court cards

The Golden Dawn named its courts King, Queen, Prince and Princess, with the King on horseback. Waite kept the older playing-card names, King, Queen, Knight and Page. Crowley renamed the Golden Dawn’s mounted King “Knight”. This site pairs the cards by rank and element, as the Golden Dawn did:

ThothShown with Waite’sElement
Knight (on a horse)King (on a throne)Fire of the suit
QueenQueenWater of the suit
Prince (in a chariot)Knight (on a horse)Air of the suit
PrincessPageEarth of the suit
Waite's King of Wands
Thoth Knight of Wands
shown with Waite’s King of Wands
Fire of Fire. Crowley’s Knight rides a horse.
Waite's Knight of Wands
Thoth Prince of Wands
shown with Waite’s Knight of Wands
Air of Fire. Crowley’s Prince rides a chariot.

The Thoth paintings themselves can’t be shown here because they are still under copyright.

The debate

Which Waite court card goes with which Thoth one is still argued over, and the decks’ own books don’t settle it. Waite’s Pictorial Key to the Tarot (1910) simply uses the playing-card names. Crowley’s Book of Thoth (1944) explains that his Knight is the Golden Dawn’s King, renamed. There are two common readings:

Both readings pair the Queens with each other, and the Princesses with Waite’s Pages. For more, see “Thoth vs Rider court cards” on Tarot Forum, and Michael Sternbach’s “How do the court cards of various decks really relate to one another?”, which argues for the second reading.

Suit and trumps

ThothWaite
DisksPentacles
VIII AdjustmentXI Justice
XI LustVIII Strength
XIV ArtXIV Temperance
XX The AeonXX Judgement
XXI The UniverseXXI The World

Waite followed the Golden Dawn in swapping Strength and Justice to VIII and XI; Crowley kept the older order, so Lust is XI and Adjustment VIII, and the printed numerals on those two pictures differ from their titles. The Magus, the Priestess and Fortune are Waite’s Magician, High Priestess and Wheel of Fortune under shorter names.

What is stored

Found a mistake in a table or a calculation? Report a bug.