io.github.alamahant.IChingDiviner

AI reads your IChing
 
  0
  no reviews




IChingDiviner is a modern I-Ching divination application that brings the ancient Chinese oracle
to your fingertips. Based on the authoritative Wilhelm/Baynes translation, it combines traditional
coin-toss divination with optional AI-powered interpretations.


Divination Methods:

  • Traditional 3-coin toss method with proper changing line mechanics
  • Manual line-by-line building or one-click auto toss for complete hexagrams
  • Visual distinction between stable and changing lines with color coding
  • Mouse entropy collection for enhanced randomness


Visualization:

  • Traditional stacked line display for hexagrams
  • Artistic seven-circle mandalas generated uniquely for each hexagram
  • Tarot-style card mode for personal deck images
  • Hover zoom for detailed viewing
  • Custom deck import system for personal use


AI Integration:

  • Optional AI interpretations with OpenAI-compatible APIs
  • Support for Groq (free tier), Mistral, OpenAI, Ollama (local), Together AI, DeepSeek
  • Context-aware prompts with source hexagram, changes, and user questions
  • Markdown-formatted responses with headers and lists
  • Secure local storage of API keys


Data Management:

  • Save and load complete divinations with lines, questions, and AI text
  • JSON format for easy backup and portability
  • Settings persistence across sessions
  • Factory reset option for settings


User Interface:

  • Dark theme designed for extended contemplation
  • Dockable panels for meanings and AI interpretations
  • Golden coin display with heads (●) and tails (â—‹)
  • Keyboard shortcuts for all major functions
  • Adjustable splitter between controls and display