Skip to content

Arcanite v0.1.0: Initial Release

Choose a tag to compare

@katelouie katelouie released this 26 Feb 23:10
· 15 commits to main since this 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