tung shing almanac

The problem

Integrating traditional Chinese almanac logic into applications is prone to calculation errors. Manual date selection for cultural events requires complex astronomical computations and adherence to imperial canons like the Xie Ji Bian Fang Shu.

What it does

• Retrieves daily auspicious and inauspicious activities based on the Tung Shing.
• Calculates the 12 hour pillars to identify specific windows for action or caution.
• Identifies zodiac clashes and affected birth years for risk mitigation.
• Finds optimal dates for weddings, business launches, and real estate transactions using scoring engines.
• Converts Gregorian dates to Lunar GanZhi and identifies 24 solar terms.

Frameworks & tools

Uses curl and jq for lightweight integration. Interfaces with the 12Zodiacs.com API for JPL DE440s astronomical precision.

Why this beats prompting it yourself

General LLMs hallucinate lunar conversions and zodiac math. This skill uses verifiable astronomical data and imperial standards, ensuring cultural accuracy and consistent results across a 200 year span.

Use cases

• Find the best weekend in the next 30 days for a wedding or move.
• Check if a specific day clashes with a user's zodiac sign before a meeting.
• Automate daily horoscopes and lucky hour notifications for lifestyle apps.
• Determine the exact moment of solar terms for seasonal content or planning.

Known limitations

The free anonymous tier is limited to a range of plus or minus 90 days from the current date. An API key is required for a wider 365 day window.