Skip to content

Home

Jump to bottom
Ken Tang edited this page Mar 24, 2026 · 1 revision

🌟 Kintaiyi 堅太乙 Wiki

Welcome to the Kintaiyi 堅太乙 wiki — the most authentic open-source Taiyi Shenshu (太乙神數) divination engine in Python.

What is Kintaiyi?

太乙神數 (Taiyi Shenshu) is one of the "Three Styles" (三式) of ancient Chinese divination, alongside Qi Men Dun Jia (奇門遁甲) and Da Liu Ren (大六壬). This millennia-old system was historically used to forecast celestial phenomena, national destiny, and major events.

Kintaiyi 堅太乙 — meaning "steadfastly adhering to the ancient methods" — faithfully implements the classical algorithms without simplification or shortcuts, enabling researchers and enthusiasts to study, verify, and apply this ancient wisdom with modern tools.

✨ Key Features

  • 🔮 Six Calculation Modes — Year, Month, Day, Hour, Minute, and Life divination
  • 📜 Four Ancient Methods — Taiyi Orthodox (統宗), Gold Mirror (金鏡), Gold Panning Song (淘金歌), Taiyi Bureau (太乙局)
  • 📊 Rich Output — Heavenly Stems & Earthly Branches, board formations, deities, 28 Mansions, 8 Gates, military predictions, historical reign cross-references
  • 🏯 Historical Reign Data — Built-in complete Chinese dynastic chronology with lunar calendar conversion
  • 🖥️ Multiple Interfaces — Python API, Typer CLI, and Streamlit GUI
  • 🤖 AI Integration — Cerebras AI for automatic board interpretation

🚀 Quick Links

Topic Description
Installation How to install Kintaiyi via pip or from source
Quick Start Get up and running in minutes
Python API Full Python API reference
CLI Reference Command-line interface usage
Calculation Modes The six calculation modes explained
Ancient Methods The four classical Taiyi methods
Output Fields Understanding the board output
Web Interface Streamlit web application guide
Contributing How to contribute to the project
FAQ Frequently asked questions

🔗 External Links

🔮 Related Projects

Project Description
堅奇門 kinqimen Python Qi Men Dun Jia (奇門遁甲)
堅六壬 kinliuren Python Da Liu Ren (大六壬)

三式齊備，古法傳承 — The Three Styles of Chinese divination, all open-sourced.

Clone this wiki locally