ERUX Astrology & Ephemeris Engine

Provide authentic, deterministic astrological framework guidance for any life question (e.g. career shift, relationship milestones, financial timing, health/somatic wellness, relocation). Corresponds to the /ask slash command in Discord, Telegram, and Google Chat. Explains which astrological houses, ruling planetary significators (Karakas), and timing triggers govern the user's inquiry. If birth details are included in the question or parameters, also computes the native's actual natal placements and active Vimshottari Dasha.

Calculate a deterministic personal natal chart or national mundane chart using the high-precision astronomical ephemeris calculation engine. Corresponds to /chart and /mundane slash commands. Supports EITHER a country name (e.g. 'India', 'USA', 'France') for a national chart OR personal birth details ('date', 'time', 'city'). Automatically provides dynamic 'chart_ui_url', calculates planetary placements, active Dasha cycle, grounded knowledge-base insights, and an ERUX interactive UI link. CRITICAL FOR AI: When calculate_chart is called, present the key placements cleanly and provide a direct, prominent link inviting the user to view their interactive chart wheel on ERUX using 'chart_ui_url' (e.g. [✨ Open Your Interactive Chart Wheel on ERUX](chart_ui_url)).

Calculate the classical Parashara Vimshottari Dasha planetary timeline (120-year cycle) for a person or founding event. Corresponds to the /dasha slash command. Requires birth date ('date', YYYY-MM-DD), birth time ('time', HH:MM, default '12:00'), and birth city ('city'). Returns current Mahadasha and Antardasha periods, active dates, psychological and karmic significance, upcoming macro-epochs, and a direct link to the interactive ERUX Dasha calendar.

Generate a personalized transit horoscope, real-world strategic forecast, and exact astronomical time-windows for a user based on their natal placements and active planetary transits. Corresponds to /horoscope and /daily commands. Supports cadences: 'daily' (today's transits and hourly Horas), 'weekly' (7-day Monday–Sunday transit arc), 'monthly' (30-day sign ingresses & lunations), and 'yearly' (12-month Solar Return to Solar Return Varshaphala journey). MANDATORY PARAMETERS: The user's natal birth date ('birth_date', YYYY-MM-DD) and natal birth city ('birth_city') are strictly required. NEVER pass today's date into 'birth_date' — today's transit date is calculated automatically by the server based on location coordinates. If the user asks for a future or target date (e.g. next week or 2027), pass that date into 'target_date', NOT 'birth_date'. Optionally accepts 'current_city' if the user has relocated, and 'cadence' ('daily', 'weekly', 'monthly', 'yearly'). For daily cadence, returns 'astronomical_time_windows' (exact topocentric sunrise/sunset, 24 planetary Horas, Rahu Kaal, Abhijit Muhurta, Brahma Muhurta) and 'panchang_timing' (exact Nakshatra and Tithi transitions). CRITICAL FOR AI: When suggesting times of day, you MUST quote the exact astronomical_time_windows provided. Never invent arbitrary hours.

Get deep personalized astrological interpretation for canonical life pillars or placements (e.g. 'career_and_vocation', 'relationships', 'dasha_analysis', 'wealth_and_finance', 'health_and_vitality'). Corresponds to the /interpret slash command in Discord and Google Chat. Can be run with or without specific birth details.

Identify auspicious & powerful classical Vedic Yogas present in a birth or mundane chart (e.g. Raja Yogas, Dhana Yogas, Pancha Mahapurusha Yogas, Gaja Kesari, Budhaditya). Corresponds to the /yogas slash command in Discord and Google Chat. Requires birth details ('date', 'time', 'city') or country name ('country'). Returns active yogas, classical definitions, and link to ERUX divisional varga breakdown.