Astro Transits

Full astrological transit calculator for AI agents. Calculates planetary positions, aspects to any natal chart, Moon phases, void-of-course periods, stations, and ingresses. Uses Swiss Ephemeris (pyswisseph) with Moshier fallback — no API key needed.

Setup

Install the dependency:

CODEBLOCK0

Generate a natal chart (one-time setup per user):

CODEBLOCK1

Parameters:

• - --date — Birth date (YYYY-MM-DD)
• INLINECODE1 — Birth time in 24h format (HH:MM)
• INLINECODE2 — Timezone name (e.g. America/New_York, Europe/London, Australia/Brisbane)
• INLINECODE6 / --lon — Birth location coordinates
• INLINECODE8 — Save chart to JSON file for reuse

Daily Transits

CODEBLOCK2

Returns: current planetary positions, active aspects to natal chart (ranked by significance), Moon sign/phase, stations, and ingresses. Top 8 aspects shown with orb, house placement, and interpretive meaning.

Weekly Forecast

CODEBLOCK3

Returns: top 3 most significant transits for the coming week with peak dates and themes.

Void-of-Course Moon

CODEBLOCK4

Returns JSON: {"voc": true/false} with end time, duration, and next Moon sign if currently void-of-course. No natal chart needed — this is a universal calculation.

What It Covers

• - Planets: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, True Node
• Aspects: Conjunction, sextile, square, trine, opposition (with variable orbs for personal vs outer planets)
• Houses: Placidus house system
• Events: Planetary stations (retrograde/direct), sign ingresses
• Moon: Phase, sign, void-of-course detection
• Interpretations: Built-in aspect meanings for all planet-aspect combinations

Notes

• - No API key or external service required — all calculations run locally
• Swiss Ephemeris provides sub-arcsecond accuracy
• Falls back to Moshier ephemeris if Swiss Eph data files are absent
• Natal chart JSON can be generated once and reused indefinitely
• Timezone handling uses Python's zoneinfo (Python 3.9+)