A curated list of tools, libraries, and resources related to Chinese metaphysics systems — including 六爻 (Liu Yao), 紫微斗数 (Zi Wei Dou Shu), 八字 (BaZi), 奇门遁甲 (Qi Men Dun Jia), 风水 (Feng Shui), and the Chinese calendar (农历/节气).
Read this in: 中文
- 六爻 (Liu Yao)
- 紫微斗数 (Zi Wei Dou Shu)
- 八字 (BaZi)
- 奇门遁甲 (Qi Men Dun Jia)
- 大六壬 (Da Liu Ren)
- 风水 (Feng Shui)
- 农历/节气 (Chinese Calendar)
- Learning Resources
Liu Yao is a classical Chinese divination method based on the I Ching (易经), using six lines (yao) derived from coin or yarrow-stalk casting to form hexagrams.
- divination-liuyao - TypeScript library for Liu Yao (六爻) divination based on the I Ching, with hexagram casting and interpretation.
- iching - Python package reproducing I Ching divination via the yarrow-stalk (蓍草) method.
- iching.js - JavaScript library for I Ching hexagram casting and lookup.
- ichingpy - Python library for Liu Yao (六爻) divination, providing hexagram generation and interpretation utilities.
Zi Wei Dou Shu is a form of Chinese astrology that maps a birth chart onto a 12-palace grid using the positions of stars and the Purple Star (紫微星).
- dart_iztro - Dart/Flutter library for Zi Wei Dou Shu (紫微斗数) and BaZi chart calculation, with true-solar-time and multi-language support.
- fortel-ziweidoushu - JavaScript/TypeScript library for Zi Wei Dou Shu (紫微斗数) chart casting in the Zhong Zhou (中州派) style.
- iztro - JavaScript/TypeScript library for Zi Wei Dou Shu (紫微斗数) chart calculation, providing palace, star, and luck-cycle data.
- py-iztro - Python port of iztro for Zi Wei Dou Shu (紫微斗数) chart generation and interpretation, with API-compatible usage.
- ziwei-chart-calculator - WordPress plugin for Zi Wei Dou Shu chart calculation with interactive palace display, focused on the Zhong Zhou school (中州派) style.
BaZi (八字, "Eight Characters") is a Chinese astrological system that derives a four-pillar chart from a person's birth year, month, day, and hour using the Heavenly Stems (天干) and Earthly Branches (地支).
- bazi - Python BaZi chart software with clash, combination, and yin-yang analysis, plus matchmaking and Feng Shui features.
- bazi-api - BaZi calculation API built with lunar-javascript, returning structured chart data.
- bazi-calculator-by-alvamind - Modern TypeScript BaZi (八字) calculator and analyzer for Node.js, covering Five Elements and Day Master analysis.
- bazi-mcp - Model Context Protocol server that returns BaZi (八字) chart data for use in AI assistants.
- bazica - Go package that converts solar dates into BaZi (八字) four-pillar charts.
- mystilight-8char - Pure JavaScript BaZi chart library with no dependencies, featuring a complete Shen Sha (神煞) system based on Yuan Hai Zi Ping.
Qi Men Dun Jia (奇门遁甲) is an advanced Chinese metaphysical system used for divination, strategy, and date selection, based on a 9-palace grid (九宫) populated with stems, gates, stars, and deities.
- kinqimen - Python package for Qi Men Dun Jia (奇门遁甲) charting, supporting hour-, minute-, and day-based methods with a Streamlit web demo.
- Qimen-Dunjia - Python framework for Qi Men Dun Jia palace layout and interpretation.
- qimen_dunjia - JavaScript module for constructing Qi Men Dun Jia charts (奇門遁甲起盤模組).
- QimenDunjia - Vue-based Qi Men Dun Jia H5 mini-program with real-time palace calculation.
Da Liu Ren (大六壬) is one of the Three Styles (三式) of Chinese divination, casting a chart from the Heavenly and Earthly plates (天地盘), Four Lessons (四课), and Three Transmissions (三传).
- daliuren-web-engine - Python Da Liu Ren (大六壬) web engine with day/night algorithms and AI-ready structured output.
- daliuren_ok - Lightweight Python package for casting Da Liu Ren (大六壬) charts.
- kinliuren - Python package for Da Liu Ren (大六壬) with Four Lessons, Three Transmissions, and a Streamlit web app.
Feng Shui (风水) is the Chinese practice of arranging environments in harmony with natural energy flows (气, qi), encompassing compass-based (玄空飞星) and form-based (形势) schools.
- Fengshui - Python implementation of Xuan Kong Flying Stars (玄空飞星) chart generation with mountain/water palace interpretation and wealth/study position analysis.
- fengshui.js - JavaScript library for Feng Shui calculations including bagua direction mapping.
- FengShuiCompass - TypeScript Lo Pan (罗盘) compass tool for directional Feng Shui analysis with customizable rings.
- mikaboshi - Rust library of Feng Shui (风水) primitives including Ba Gua (八卦), Gan Zhi (干支), and the Nine Stars (九星).
Tools for working with the Chinese lunisolar calendar (农历), the 24 solar terms (二十四节气), Heavenly Stems (天干), and Earthly Branches (地支).
- chinese-calendar - Python package for determining Chinese public holidays and workdays, with Gregorian/lunisolar date support.
- jieqi - Python program for calculating the precise times of the 24 solar terms (节气) across multiple time zones, accurate to the second.
- lunar-java - Comprehensive Java library for the Chinese lunar calendar, solar terms, stem-branch, and almanac data.
- lunar-javascript - JavaScript library for Chinese lunar/solar calendar conversion and solar term calculation.
- lunar-mcp-server - Model Context Protocol server exposing Chinese lunar calendar, solar terms, and auspicious-date tools to AI assistants.
- lunar-python - Comprehensive Python library for Chinese lunar calendar, solar terms, and stem-branch date conversion.
- Lunar-Solar-Calendar-Converter - Lunar/solar (农历/公历) date converter for 1900–2100 with C#, Java, Python, JavaScript, and Go implementations.
- iztro Documentation — Zi Wei Dou Shu Guide - Official documentation for the iztro library, covering Zi Wei Dou Shu palace interpretation, star analysis, and luck-cycle calculation.
- Joey Yap's BaZi Profiling Series - Structured course materials for BaZi four-pillar analysis from a prominent Malaysian practitioner.
- Qi Men Dun Jia Compendium — Joey Yap - Reference text covering the theory and practical application of Qi Men Dun Jia.
- The Astrology of I Ching — W.A. Sherrill & W.K. Chu - Classic introduction to Liu Yao divination methodology.
- The Complete I Ching — Alfred Huang - Authoritative English translation of the I Ching with detailed hexagram commentary.
- ziwei-doushu-wiki - Open-source Zi Wei Dou Shu wiki covering the 14 main stars, 12 palaces, four transformations (四化), and chart calculation logic.
Contributions are welcome! Please read the contribution guidelines before submitting a pull request.