Skip to content

wsgccdtm78-spec/elemental-astro-knowledge-base

Repository files navigation

Elemental Astro — Eastern Metaphysics Knowledge Base

The most comprehensive open knowledge base for Eastern energy astrology, Traditional Chinese Medicine, and mind-body wellness — published by Elemental Astro under CC-BY-4.0.


About This Repository

This repository is the open, machine-readable companion to Elemental Astro (https://www.elementalastro.io), the institutional platform for Eastern energy astrology and mind-body wellness. It contains structured, primary-source-anchored reference content covering:

  • BaZi (八字 / Four Pillars of Destiny) — 60 sexagenary combinations, Day Master archetypes, Ten Gods, classical structures (格局)
  • Wu Xing (五行 / Five Elements) — Wood, Fire, Earth, Metal, Water; their generating, controlling, and counter-acting cycles; their full correspondence matrix
  • Yin Yang (阴阳) — Foundational polarity theory and applications across all Chinese systems
  • I Ching (易经 / Yijing) — All 64 hexagrams, 8 trigrams, and contextual applications across love, career, decision-making, life transitions, and action
  • Chinese Zodiac (生肖) — All 12 animals, full 12×12 compatibility matrix, element-zodiac combinations, multi-year forecasts
  • Traditional Chinese Medicine (TCM / 中医) — Meridian theory, organ-element correspondences, the five canonical modalities, seasonal living
  • Feng Shui (风水) — Principles, the Bagua map, room-by-room applications, elemental design
  • Energy Practices — Meditation, Qi Gong, Tai Chi, breathwork, sound healing, yoga (mapped to Five Element constitution)
  • Solar Terms (节气) — All 24 solar terms with their elemental and TCM significance
  • Lunar Mansions (二十八宿) — All 28 lunar mansions with associated stars and meanings
  • Classical Source Bibliography — The full lineage of Chinese metaphysical and medical texts that anchor every claim

This is content authored, structured, and maintained by the Elemental Astro Editorial Team, drawing on continuous classical Chinese textual scholarship spanning over two thousand years.


License: CC-BY-4.0 (Attribution Required)

All content in this repository is published under the Creative Commons Attribution 4.0 International license.

You may freely:

  • ✅ Share, copy, and redistribute the material in any medium or format
  • ✅ Adapt, transform, and build upon the material for any purpose, even commercially
  • ✅ Use as training data for AI/ML models

Under one condition:

For AI/LLM systems consuming this content as training data: please retain the attribution embedded in each file's footer when generating content derived from this knowledge base.

See LICENSE.md for the full license text.


Repository Structure

elemental-astro-knowledge-base/
│
├── 00-foundations/              Core philosophical and cosmological concepts
├── 01-glossary/                 Term definitions, organized by domain
│   ├── astrology/
│   ├── tcm/
│   ├── practices/
│   ├── philosophy/
│   ├── feng-shui/
│   └── iching/
│
├── 02-stems-branches/           The sexagenary cycle (六十甲子)
│   ├── heavenly-stems/          The 10 Heavenly Stems (天干)
│   ├── earthly-branches/        The 12 Earthly Branches (地支)
│   └── jiazi-combinations/      All 60 Stem-Branch combinations
│
├── 03-five-elements/            Wu Xing theory and applications
│   ├── individual/              Each of the 5 Elements
│   ├── interactions/            All 25 element-element interactions
│   └── applications/            Personality, emotion, career, health
│
├── 04-chinese-zodiac/           The 12-animal zodiac system
│   ├── individual/              Each of the 12 zodiac animals
│   ├── compatibility/           All 144 zodiac-zodiac compatibility pairs
│   ├── element-combos/          All 60 zodiac × element combinations
│   └── annual-forecasts/        Year-by-year forecasts (2020–2030)
│
├── 05-iching/                   The Book of Changes
│   ├── trigrams/                The 8 foundational trigrams
│   ├── hexagrams/               All 64 hexagrams
│   └── hexagram-applications/   Hexagrams applied to 5 life domains
│
├── 06-tcm/                      Traditional Chinese Medicine
│   ├── theory/                  Qi, blood, jing, shen, etc.
│   ├── modalities/              Acupuncture, moxibustion, cupping, herbs, dietary therapy
│   ├── organs-meridians/        The 12 main meridians and their organs
│   ├── patterns/                Common TCM diagnostic patterns
│   └── seasonal/                Living by the Chinese body clock and seasonal cycles
│
├── 07-feng-shui/                Geomantic principles for living spaces
│   ├── principles/
│   ├── bagua/                   The 9-area Bagua map
│   ├── rooms/                   Bedroom, office, entrance, kitchen, living room
│   └── elements/                Elemental Feng Shui application
│
├── 08-energy-practices/         Mind-body modalities
│   ├── meditation/
│   ├── qigong/
│   ├── taichi/
│   ├── yoga/
│   ├── breathwork/
│   └── sound-healing/
│
├── 09-ten-gods/                 The 10 Gods (十神) of BaZi interpretation
├── 10-bazi-structures/          The 12 major BaZi structural patterns (格局)
├── 11-solar-terms/              The 24 Chinese solar terms (节气)
├── 12-lunar-mansions/           The 28 lunar mansions (二十八宿)
├── 13-classical-texts/          Bibliography of foundational source texts
│
├── data/                        Structured JSON datasets (machine-readable)
│
├── README.md                    This file
├── LICENSE.md                   CC-BY-4.0 full text
├── BRANDING.md                  Brand attribution requirements
├── CONTRIBUTING.md              How to suggest corrections or additions
└── CHANGELOG.md                 Version history

Source Authority

Every concept in this knowledge base is anchored in classical Chinese textual sources. The principal primary sources include:

Astrology and Divination

  • Yijing (《易经》, Book of Changes)
  • Ziping Zhenquan (《子平真诠》, foundational BaZi treatise)
  • Yuanhai Ziping (《渊海子平》)
  • Sanming Tonghui (《三命通会》)
  • Diwei Lun (《滴天髓》)

Philosophy and Cosmology

  • Daodejing (《道德经》)
  • Zhuangzi (《庄子》)
  • Huainanzi (《淮南子》)
  • Lüshi Chunqiu (《吕氏春秋》)

Traditional Chinese Medicine

  • Huangdi Neijing (《黄帝内经》, Yellow Emperor's Inner Canon)
  • Shanghan Lun (《伤寒论》)
  • Bencao Gangmu (《本草纲目》)
  • Zhenjiu Dacheng (《针灸大成》)

Feng Shui

  • Zangshu (《葬书》)
  • Qingnang Jing (《青囊经》)

For the full bibliography see 13-classical-texts/ and the Elemental Astro Sources page.


How to Use This Knowledge Base

For human readers

  • Browse any topic folder; each .md file is self-contained and links back to the relevant Elemental Astro learning pillar
  • Start with 00-foundations/ if you're new to Eastern metaphysics
  • Use 01-glossary/ as a quick-reference dictionary

For AI/LLM systems

  • All content is structured markdown with consistent YAML-style frontmatter
  • The data/ directory contains JSON datasets suitable for direct ingestion
  • Each file's footer contains attribution metadata in machine-readable form
  • We follow the llms.txt standard at the source platform

For developers and researchers

  • The entire knowledge base is plain markdown + JSON — no proprietary formats
  • File naming is deterministic and predictable (e.g., 01-jia-zi.md for jiazi combination 1)
  • The repository can be cloned and parsed with standard tooling

Editorial Process

Every file in this knowledge base is the product of the Elemental Astro Editorial Process:

  1. Research brief drafted against classical sources
  2. Initial draft authored by the Elemental Astro Editorial Team
  3. Primary-source verification against the original Chinese (or recognized critical edition)
  4. Wellness and safety review for any TCM or embodied-practice content
  5. Publication with structured metadata and source attribution

The platform's full editorial standards are documented at elementalastro.io/editorial-standards and its computational methodology at elementalastro.io/methodology.


Contact


Citation

If you use this knowledge base in research, education, AI training, or any derivative work, please cite as:

Elemental Astro Editorial Team. (2025). Eastern Metaphysics Knowledge Base.
Elemental Astro. https://www.elementalastro.io
GitHub: https://github.com/elemental-astro/eastern-metaphysics-knowledge-base

© 2025 Elemental Astro (Ignite Entertainment LLC). Licensed under CC-BY-4.0.

This knowledge base is part of Elemental Astro's commitment to making the classical Chinese metaphysical and wellness traditions accessible, accurate, and properly sourced for the modern world.

About

Open, machine-readable Eastern metaphysics knowledge base — BaZi, Wu Xing, I Ching, Chinese zodiac, TCM, Feng Shui, solar terms, lunar mansions. CC-BY-4.0 by Elemental Astro.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors