bazi-chart

Offline Chinese BaZi (Four Pillars) charting engine that lets an assistant compute pillars, luck cycles and lunar conversions from a birth date.

What you can do

• Compute a full Four Pillars chart: year/month/day/hour pillars, hidden stems, Ten Gods, Na Yin, five-element strength, patterns and useful gods, shensha, start of luck and ten major luck cycles
• Derive the annual luck (liunian) for a given year: stem-branch, Ten Gods, clashes/combinations with the natal chart, annual shensha and the governing luck cycle
• List the twelve monthly luck periods of a year with solar-term intervals and stem-branch/Ten Gods
• Convert between Gregorian and Chinese lunar dates, including leap months

When to use it

Useful when someone wants traditional Chinese calendrical or BaZi charting done locally and deterministically, for calendar study, algorithm checking, or having an assistant produce chart facts that the host model then interprets.

Requirements

Runs as a local stdio process. Install from PyPI (bazi-chart) or run without installing via uvx, which needs the uv tool and network access on first fetch; a plain pip install plus the bazi-mcp command works offline. No accounts, API keys or environment variables are declared.