ziweiknows/ziwei-chart

What it solves

Ziwei Chart provides a way for users to accurately generate, visualize, and understand Ziwei Dou Shu (Purple Star Astrology) charts. It solves the problem of complex manual chart calculation and the lack of intuitive visual tools for analyzing life trends and relationship compatibility.

How it works

Users input their birth date, time, gender, and location. The application uses the iztro engine for deterministic chart generation, ensuring that the positions of stars and palaces are calculated accurately rather than guessed by an AI. It incorporates local city coordinates and true solar time correction for higher precision. The resulting data is then visualized through twelve-palace charts, annual trend analysis, and "Life K-lines" for long-term trajectory tracking. While the core calculations are deterministic, users can optionally connect an OpenAI-compatible API to receive AI-assisted interpretations of the generated facts.

Who it’s for

It is designed for general users interested in Ziwei Dou Shu for self-exploration, cultural study, or analyzing life patterns and interpersonal relationships.

Highlights

• Deterministic Charting: Uses a dedicated engine (iztro) to ensure astronomical accuracy instead of relying on LLM hallucinations.
• True Solar Time Correction: Automatically adjusts birth time based on geographic coordinates.
• Visual Trend Analysis: Includes "Life K-lines" and annual/monthly trend views to map out life stages.
• Compatibility Analysis: Supports dual-chart matching to understand interactions between two people.
• AI Integration: Allows optional connection to models like DeepSeek, Claude, or Gemini for explanatory interpretations.