Junhyuk Lee

You can request two outputs: today's daily fortune based on the current 일진, and a life destiny reading computed from your 사주 (Four Pillars of Destiny). It also generates a 매화역수 I-Ching hexagram, all written in plain English without untranslated jargon.

It targets general users interested in Korean fortune-telling traditions — 운세, 사주, 명리, horoscopes, and I-Ching — who want accessible readings. No prior knowledge of Four Pillars terminology is required, since all output is explained in plain language by default.

It uses the lunar-python library to compute real 사주 charts, the current 일진 (daily pillar), and 매화역수 hexagrams. After your first use, your birth profile is stored so subsequent readings do not require re-entering birth details.

You need the lunar-python library available in the runtime environment, since all 사주, 일진, and hexagram calculations depend on it. For a life destiny reading, you must also provide your birth information once, which is then stored for future sessions.

Default output is English. Although it handles Korean concepts like 운세, 사주, and 명리, readings are written in plain English with no untranslated jargon, making traditional Korean divination accessible to non-Korean speakers.