DEV Community

kk mors
kk mors

Posted on

I Built an AI-Powered Chinese BaZi (八字) Fortune Teller — Here's What DeepSeek Revealed About Destiny

#ai #python #astrology #chinese

The Algorithm That's Been Running for 3,000 Years

Most people think "Chinese fortune telling" is either superstitious nonsense or a mysterious old man with a beard.

The reality? BaZi (八字, literally "Eight Characters") is a deterministic algorithm. Your birth year, month, day, and hour map to specific Heavenly Stems (天干) and Earthly Branches (地支). These aren't random — they follow a 60-year cycle that's been documented since the Han Dynasty.

When I first learned this, I thought: This is literally a function. Input = birth datetime. Output = personality/life chart. Why can't I automate this?

Turns out, you can.

The Tech Stack

I built SoulChart over a weekend:

Python (lunar_python) → BaZi calculation engine
FastAPI → backend API
DeepSeek Chat → AI interpretation
Next.js 16 → frontend
PIL → share card generation
Enter fullscreen mode Exit fullscreen mode

The hard part wasn't the astrology math (lunar_python handles the lunar/solar calendar conversion). The hard part was making the AI interpretation actually meaningful instead of generic horoscope fluff.

How BaZi Actually Works (Simplified)

Here's the core algorithm:

from lunar_python import Solar8Char, Solar

def calculate_bazi(year, month, day, hour):
    solar = Solar.fromYmdHms(year, month, day, hour)
    eight_char = Solar8Char(solar)

    return {
        "four_pillars": eight_char.getBaZi(),      # 年柱, 月柱, 日柱, 时柱
        "day_master": eight_char.getDayGan(),       # 日主 (your core element)
        "zodiac": eight_char.getShengXiao(),        # 生肖
        "five_elements": eight_char.getWuXing(),    # 五行统计
    }
Enter fullscreen mode Exit fullscreen mode

Your Day Master (日主, the heavenly stem of your day pillar) is your core essence. For example:

  • 甲/乙 (Wood) — Growth-oriented, flexible, creative
  • 丙/丁 (Fire) — Passionate, expressive, sharp
  • 戊/己 (Earth) — Stable, reliable, nurturing
  • 庚/辛 (Metal) — Determined, structured, precise
  • 壬/癸 (Water) — Adaptive, deep, intuitive

The interaction between your Day Master, the four pillars, and the Five Elements creates a uniquely detailed personality profile — much more granular than Western zodiac sun signs.

Where AI Comes In

The lunar_python library gives you the raw data. But raw data doesn't help anyone.

That's where DeepSeek shines. Instead of generic "you'll meet someone special" readings, I prompt it with the actual BaZi data:

"Day Master is 己 (Earth). Born in Dragon year. Four Pillars: [data]. Five Elements: 2 Wood, 1 Fire, 3 Earth, 1 Metal, 1 Water."

The AI reads this like a trained BaZi master and produces:

  • Personality analysis (accurate enough that my friends said "that's scary")
  • Relationship dynamics (which elements complement yours)
  • Career direction (which industries suit your element)
  • Yearly forecast (how the current year's element interacts with yours)

The Invite Mechanic — Why It's Not Just a Paywall

I hate paywalls. So instead of "pay or leave", SoulChart uses a share-to-unlock model:

  1. Enter your birth info → Get free four pillars + short AI preview
  2. Share with 3 friends → Unlock the full Love Report for free
  3. Or buy instantly for $3.99-$7.99

The idea is: BaZi readings are best when discussed with friends. Your Wood element interacts with someone's Fire differently. It becomes a social experience.

What I Learned Building This

  1. Ancient systems are underrated. BaZi has been refined for millennia. The fact that it maps to a deterministic algorithm makes it perfect for AI augmentation.

  2. DeepSeek handles Chinese cultural context better than GPT. For non-Western subjects like BaZi, specialized models make a real difference.

  3. Gen Z loves this stuff. The astrology + tech crossover resonates with younger audiences who want personalized digital experiences.

  4. Free preview + social unlock converts better than free trial. People are more willing to share than to pay upfront — and sharing brings more users.

Try It Yourself (Free, No Signup)

The free preview gives you your Four Pillars chart, Day Master analysis, and Zodiac sign immediately. No email required.

👉 Get Your Free BaZi Reading

If you invite 3 friends, the full Love Report unlocks automatically. Or grab the complete reading for $3.99.

I'd love to hear: What's your Day Master? Drop your birth year + animal in the comments, and I'll tell you what your element says about your personality. 🔮

Top comments (0)