superzhang21/metaphysics-steward

★ 14PythonAudience · researcherComplexity · 2/5Setup · easy

Mindmap

mindmap
  root((repo))
    What it does
      Seven divination systems
      Birth chart analysis
      True solar time correction
      JSON output
    Divination Systems
      Bazi Four Pillars
      Ziwei Doushu
      Qimen Dunjia
      Liuyao I Ching
    Tech Stack
      Python CLI
      lunar-python library
      No internet needed
    Use Cases
      Cultural research
      AI agent skill
      Astrology study
      Data pipeline input

mindmap root((repo)) What it does Seven divination systems Birth chart analysis True solar time correction JSON output Divination Systems Bazi Four Pillars Ziwei Doushu Qimen Dunjia Liuyao I Ching Tech Stack Python CLI lunar-python library No internet needed Use Cases Cultural research AI agent skill Astrology study Data pipeline input

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Study traditional Chinese divination systems like Bazi and Ziwei Doushu as cultural or historical artifacts.

USE CASE 2

Generate a structured JSON chart from a birth date and location to feed into an AI agent or analysis pipeline.

USE CASE 3

Use as a callable skill inside an AI assistant that supports tool-calling to run divination analysis mid-conversation.

USE CASE 4

Explore how classic Chinese calendrical systems convert between Gregorian and lunisolar dates programmatically.

Tech stack

Pythonlunar-pythonCLI / command-line

Getting it running

Difficulty · easy Time to first run · 5min

Install the single dependency (lunar-python via pip), then run the main script with birth date, time, sex, location, and a mode flag. No internet, database, or API key required.

License not mentioned in the explanation. The README notes the tool is for research and cultural learning only, not for major life or financial decisions.

In plain English

Metaphysics Steward is a Python command-line tool that implements seven systems of traditional Chinese divination and astrology. The README is written in Chinese, and the project is aimed at users interested in studying these practices as cultural artifacts or technical curiosities. The disclaimer at the top of the README explicitly says the tool is for research and cultural learning only, and warns against using it for major life or financial decisions. The seven systems it covers are Bazi (Four Pillars of Destiny, a form of birth-chart analysis based on the year, month, day, and hour of birth), Ziwei Doushu (Purple Star Astrology, a detailed chart system), Qimen Dunjia (a strategic divination system involving a nine-palace grid), Da Liuren (another time-based divination grid method), Meihua Yishu (Plum Blossom Numerology, which uses numbers or the current time to derive a hexagram reading), Jinkoujue (a method attributed to historical strategists), and Liuyao (six-line hexagram divination based on the I Ching). All seven are accessible through a single Python script. You pass in a birth date and time, a sex parameter, and a location (either a city name or a longitude coordinate), along with a mode flag that selects which system to run. The tool corrects for true solar time, which differs from standard clock time depending on longitude. It includes coordinates for over 30 Chinese cities so users can supply a city name rather than a raw longitude. The tool can also output results as JSON, which makes it easier to pipe the structured data into other programs or AI agents. The README describes how AI agents that support tool-calling can load this project as a skill and invoke the analysis directly from a conversation. The only external dependency is a library called lunar-python, which handles conversions between the Gregorian calendar and the traditional Chinese lunisolar calendar. No database, no web service, and no internet connection are required after installation.

Copy-paste prompts

Prompt 1

I have a Python CLI tool for Chinese divination (Bazi, Ziwei Doushu, Qimen Dunjia, etc.). Given a birth date of 1990-05-15, time 08:30, male, city Beijing, write the exact command to run a Bazi analysis and explain each part of the output.

Prompt 2

Using the metaphysics-steward JSON output format, write a Python script that calls the CLI for a list of birth dates and saves each result to a separate JSON file.

Prompt 3

I want to add metaphysics-steward as a tool-callable skill in my AI agent. Show me how to wrap the CLI call in a Python function with input validation so an LLM can invoke it safely.

Prompt 4

Explain what true solar time correction means in this tool and why the longitude or city name parameter matters for the accuracy of a Bazi or Qimen Dunjia reading.

Prompt 5

Compare the seven divination systems this tool implements, Bazi, Ziwei Doushu, Qimen Dunjia, Da Liuren, Meihua Yishu, Jinkoujue, and Liuyao, in plain English. What question is each system best suited to explore?

Open on GitHub → Explain another repo

← superzhang21 on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.