IChingDiviner

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