Skip to content

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FateMaster

FateMaster

A deterministic engine draws the chart. AI reads it back in plain language.

BaZi · Zi Wei Dou Shu · Liu Yao · Mei Hua Yi Shu · Qi Men Dun Jia · Tarot · Chinese Almanac

English · 简体中文 · 繁體中文 · 日本語 · 한국어

Open the site in your language: EN · 简体 · 繁體 · 日本語 · 한국어


What it does

Most AI fortune-telling tools hand the whole job to a language model and hope it knows what a Four Pillars chart looks like. FateMaster splits the work: a rule engine computes the chart deterministically, then the AI interprets what the engine produced.

The chart is reproducible. Ask twice, get the same pillars. What changes between readings is the reading, not the astronomy.

Core readings are free and need no signup.

The seven systems

System Workspace What it answers
BaZi (Four Pillars) /workspace/bazi-calculate The natal pattern and its changes through Luck Cycles
Zi Wei Dou Shu /workspace/ziwei-doushu The twelve palaces and star placements
Liu Yao /workspace/liuyao A specific question, cast as a hexagram
Mei Hua Yi Shu /workspace/meihua/daily-decision A decision you need to make today
Qi Men Dun Jia /workspace/qimen Timing and direction for a plan
Tarot /workspace/tarot An open question, through image and symbol
Chinese Almanac /workspace/huangli What today is suited to, and picking a date

Plus Daily Fortune — your own chart read against today.

Relationship analysis

Compatibility usually means one thing: romance. Real relationships are more varied than that, and each pairing reads differently in BaZi.

Marriage Dating compatibility
Business partnership Leader and subordinate
Parent and child Mother and child
Mother-in-law Close friends
Friends Relationship network

Features

  • True solar time correction — birth time adjusted for longitude, not just the clock on the wall. See why it matters
  • Solar or lunar birth date, or enter the four pillars directly if you already know them
  • Follow-up questions — the chart stays in context, so you can keep asking
  • History — readings are saved, not thrown away when you close the tab
  • Reading styles for Tarot — the same spread, read four different ways
  • Five languages — English, Simplified and Traditional Chinese, Japanese, Korean

How it works

Charting is pure computation: solar terms, the sexagenary cycle, true solar time correction, palace and star placement. That runs first, in code, with no model involved — which is why the same birth data always produces the same chart.

The AI layer sits on top. It receives the computed chart as structured data and explains it: what the pattern means, how the elements interact, what the current Luck Cycle changes. It reads the chart; it does not invent it.

Guides

Reference material on the concepts behind the charts — useful whether or not you ever run a reading.

FoundationsWu Xing (Five Elements) · Tian Gan (Heavenly Stems) · Di Zhi (Earthly Branches) · Liu Shi Jia Zi (Sexagenary Cycle) · Na Yin

Reading a chartShi Shen (Ten Gods) · Ge Ju (Structure) · Shen Sha · Xing Chong Hui He (Interactions) · Da Yun (Luck Cycles) · Qi Yun (Starting Time)

Time and calendarTrue Solar Time · Zi Hour Theory

Other systems64 Hexagrams · Qi Men Dun Jia · Feng Shui · Tarot cards

Worked examples: Mingli case studies · Blog

Pricing

Core readings are free. Paid plans unlock the full analysis depth across every system.

Day Pass $15 / day
Yearly $59 / year — early bird, list price $299, renewal price locked

See pricing for what each plan includes.

Built with

Next.js 15 · React · TypeScript · Tailwind CSS · lunar-typescript and lunar-javascript for the calendar and sexagenary math · OpenAI via the AI SDK for interpretation · Better Auth · Stripe

About this repository

This is the public home for FateMaster — issues, feedback, and corrections to the reference material are welcome here. The application source is not open source.

Found a charting error? Open an issue with the birth data and what you expected. Chart accuracy reports are genuinely useful and get fixed fast.

Links


八字 · 紫微斗數 · 四柱推命 · 사주 · Four Pillars of Destiny

About

AI-powered Chinese metaphysics workbench — BaZi, Zi Wei Dou Shu, Liu Yao, Mei Hua Yi Shu, Qi Men Dun Jia, Tarot and the Chinese Almanac. A deterministic engine draws the chart; AI reads it back.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors