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