learnwithu/mingli-master

What it solves

It eliminates the inaccuracies often found when LLMs attempt to perform Zi Wei Dou Shu (Chinese astrology) calculations. By separating precise mathematical chart casting from the linguistic interpretation, it ensures that astrological reports are based on 100% accurate astronomical and rule-based data rather than LLM hallucinations.

How it works

The system uses a hybrid pipeline to generate reports:

1. Precise Calculation: A Python script uses the iztro-py library to calculate the distribution of stars, four transformations (Si Hua), and decade cycles.
2. Deterministic Rule Engine: A dedicated rules engine determines specific astrological patterns (geju), handles empty palaces by borrowing stars, and scans for "stress" points (Hua Ji) across different timeframes.
3. LLM Interpretation: The LLM takes the structured data from the rule engine and translates it into a human-readable, empathetic report based on provided interpretation guides.
4. Visualization: The final output is rendered as an HTML report with two selectable themes ("Classic" and "Cyber").
5. Palmistry Integration: Optionally, it can cross-reference palmistry features from photos or text with the chart data.

Who it’s for

People interested in Zi Wei Dou Shu who want accurate, data-driven astrological analysis combined with the natural language capabilities of AI agents.

Highlights

• Hybrid Architecture: Combines Python for math/rules and LLMs for natural language interpretation.
• Visual Reports: Generates HTML reports featuring a macro-pattern dashboard and a "spatio-temporal pressure heatmap."
• Deterministic Results: Ensures the same birth data always produces the same chart and pattern determination.
• Multi-theme UI: Offers a gold-black classical theme and a glowing cyber-card theme.
• Agent-Ready: Compatible with the Agent Skills protocol for easy integration into runtimes like Claude Code or Cursor.