Arcanite v0.2.0: Lenormand and PDF Rendering

Arcanite 0.2.0 — Multi-System Oracle Support

Arcanite is no longer just a tarot library. Starting with 0.2.0, it's an oracle systems framework — and Lenormand is the first new tradition to join the family.

Complete Lenormand Deck

All 36 cards with a rich, purpose-built schema:

• Directional combinations — cards read differently depending on sequence (Ship + Anchor ≠ Anchor + Ship)
• Stratified combination sampling — curated pairings across person, positive, negative, and neutral categories, plus fallback grammar rules for LLM synthesis of unlisted pairs
• Topic contexts — love, career, health, finances, spiritual interpretations per card
• Timing data — duration, speed, and direction for predictive readings
• Grand Tableau support — house meanings with near/far significator interpretations
• Line reading positions — dedicated guidance for first, middle, and last positions in spreads

Spread definitions included for 3-card and 5-card line readings, plus full 36-card Grand Tableau with house mappings.

PDF Report Generation

New Typst-based rendering pipeline turns readings into polished PDF reports:

• Spread visualization with positioned card images and position labels
• Card-by-card sections with images, interpretations, and keywords
• Reversed cards displayed upside-down (because details matter)
• Conditional synthesis section for LLM-generated readings
• Card relationship display
• Uses the Python typst package — no CLI installation required

Multi-System Architecture

The internal structure now supports multiple oracle traditions through a unified interface:

• Cards organized by system: cards/json/tarot/, cards/json/lenormand/
• Spreads organized by system: tarot-spreads.json, lenormand-spreads.json
• TarotDeck.load() and SpreadRegistry.from_config() accept a system parameter (defaults to "tarot")

New Tradition Prompt

• kate-signature.yaml — A psychologically rich, analytical reading style. The "compassionate scalpel": warm but precise, grounded in pattern recognition.

Cookbook

New examples/cookbook.ipynb walks through the full pipeline: loading decks, creating readings, deterministic and LLM-synthesized PDFs, question classification, tradition prompts, and local LLM usage with Ollama.

Migration Notes

If upgrading from 0.1.0, note the following path changes:

Before (0.1.0)	After (0.2.0)
cards/json/*.json	cards/json/tarot/*.json
spreads-config.json	tarot-spreads.json

If you were loading cards or spreads with default paths, the new system="tarot" default should handle this transparently. If you hardcoded paths, you'll need to update them.

Install / Upgrade

pip install --upgrade arcanite

Arcanite v0.1.0: Initial Release

Arcanite is a Python tarot reading engine with a two-layer interpretation system: deterministic assembly of curated card meanings, plus optional LLM synthesis for cohesive narrative readings.

Highlights:

• 78 richly-detailed tarot cards with position-specific interpretations, question contexts, and card relationship mappings
• 11 spread layouts from single-card daily pulls to the full Celtic Cross
• Two-layer interpretation
  • Layer 1 assembles pre-curated, position-aware content via RAG mapping (no hallucination)
  • Layer 2 optionally synthesizes it into flowing narrative via LLM
• Multiple LLM providers: Anthropic (Claude), OpenAI, or local models via Ollama
• Auto-detection of question type (love, career, spiritual, etc.) for context-aware readings
• Deterministic-only mode for LLM-free usage
• Protocol-based architecture designed for future expansion to Lenormand, Kipper, and other oracle systems

Install:

pip install arcanite
pip install arcanite[llm]  # for LLM synthesis