A few weeks ago I bookmarked a viral post: "5 fortune-telling Skills on GitHub you should save." BaZi, ZiWei, QiMen, Tarot — thousands of stars combined. I bookmarked it too. And like most people, I never got past the bookmark.
When I finally dug in, I found a problem worse than setup friction: AI fortune-telling fails on the chart itself.
The chart is math, not prose
A BaZi "Four Pillars" chart or a ZiWei star map is deterministic calculation — dense rules, zero room for vibes. Ask a model to compute a chart from memory and it will get the day pillar wrong, then write you a gorgeous, confident, completely wrong reading.
Experts spot it immediately. Everyone else gets misled beautifully.
The projects that got it right
The most interesting repos in this wave take calculation away from the model:
- TaiBu (github.com/hhszzzz/taibu) — fifteen local divination engines: BaZi, ZiWei, LiuYao, MeiHua, QiMen, Tarot, Western astrology, Chinese almanac. Charts are computed by a bundled engine; the model interprets, never calculates.
- BaZi Skill (github.com/jinchenma94/bazi-skill) — interpretation rules distilled from nine classical texts into a structured framework.
- Mingyu (github.com/Brhiza/mingyu) — chart workflows plus a public API that turns charts into AI-readable structured data.
What we built
We packaged these three into one ready-to-use Agent. You ask in plain language — "born May 20, 1990, 8 AM" — the Agent runs the real engines, then interprets the verified chart with classical rules.
I tested it with a known birth input: the computed pillars matched manual cross-checking exactly (Geng-Wu year, Xin-Si month, Yi-You day, Geng-Chen hour). That's the bar: the reading can be subjective, the chart cannot.
If you're building anything in the AI-metaphysics space, steal this architecture: deterministic engine for facts, model for interpretation, and never let the two trade places.
Try it: Fortune Reading Agent on ClawMama — one click, then chat with it in Telegram, WhatsApp or Discord.
Originally published at https://clawmama.run/blog/fortune-reading-agent
Top comments (0)