mizukaizen 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:
pip install pyswisseph
Generate a natal chart (one-time setup per user):
python3 {baseDir}/scripts/natal_chart.py \
--date "1993-05-13" \
--time "01:20" \
--tz "Australia/Brisbane" \
--lat -27.2308 --lon 153.0972 \
--save natal.json
Parameters:
--date— Birth date (YYYY-MM-DD)--time— Birth time in 24h format (HH:MM)--tz— Timezone name (e.g.America/New_York,Europe/London,Australia/Brisbane)--lat/--lon— Birth location coordinates--save— Save chart to JSON file for reuse
Daily Transits
python3 {baseDir}/scripts/transits.py --chart natal.json
python3 {baseDir}/scripts/transits.py --chart natal.json --date 2026-03-15
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
python3 {baseDir}/scripts/transits.py --chart natal.json --week
Returns: top 3 most significant transits for the coming week with peak dates and themes.
Void-of-Course Moon
python3 {baseDir}/scripts/voc_check.py
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+)