Skip to content

Arcanite v0.2.0: Lenormand and PDF Rendering

Latest
Latest

Choose a tag to compare

View all tags
@katelouie katelouie released this 27 Feb 06:34
· 3 commits to main since this release
v0.2.0
b62e9f8

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
Assets 2
Loading