Bazi-skill is a Python library for Four Pillars of Destiny divination analysis. The Four Pillars system is a traditional Chinese method of interpreting destiny and personality based on the year, month, day, and hour of birth, each represented by a pair of heavenly stems and earthly branches. This tool automates the calculation and analysis of these astrological components from a person's birth information.
The library solves the problem of manually computing the complex mappings between Gregorian calendar dates and the traditional Chinese calendar system, then deriving the corresponding stems and branches for each pillar. Rather than requiring users to perform these calculations by hand or consult reference tables, the tool accepts birth date and time input and returns the complete Four Pillars configuration along with interpretive analysis. This approach makes the divination system accessible to developers building applications that incorporate traditional Chinese metaphysical practices.
Developers considering this tool should understand it targets applications that need to integrate Four Pillars analysis into their systems, such as astrology apps, fortune-telling platforms, or cultural software. The project is most suitable for those building in the Chinese cultural context or serving users interested in traditional divination methods. The README provides no comparison to alternative implementations, so evaluation should focus on whether the library's specific analysis approach and output format match your application's needs.
The project shows minimal development activity with no recent commits or updates to the codebase. There are no open issues or pull requests, suggesting either a completed state or dormant maintenance. The lack of ongoing development means users should not expect bug fixes, feature additions, or compatibility updates with future Python versions without forking the project themselves.
