Transit Data Calculator

Astrologically speaking, "transits" are where the sky is today - the current positions of the planets - and they're what every daily horoscope is built from. Transit Data Calculator is the Comfyui-Kerykeion node that answers "what's the sky doing right now (or on any date you pick)?" and hands you a Spanish JSON summary: all ten planets in their current signs, plus a simplified moon phase.

It's the steady daily-driver of the pack. Where Natal Chart Calculator is about a person and Synastry Calculator is about a relationship, this one is about a moment.

How it works

The familiar three-step pipeline - geocode reference_city via Nominatim, resolve its timezone with timezonefinder, then build a kerykeion AstrologicalSubject with online=False so the actual planetary positions are computed locally via Swiss Ephemeris. The output JSON gives you:

• posiciones_actuales - where each of the ten planets (sol, luna, mercurio, venus, marte, jupiter, saturno, urano, neptuno, pluton) sits in the zodiac, with sign names translated to Spanish.
• fase_lunar - the moon phase, collapsed to four simplified buckets: Nueva, Creciente, Llena, Menguante.

Note that simplification: kerykeion tracks eight fine-grained phases (Waxing Gibbous, Balsamic…), but this node deliberately folds them into the four you'd put on a calendar. If you need the nuance, this isn't the node - it's built for LLM-readable summaries, not astronomy nerds.

The inputs that matter

• target_year, target_month, target_day - the date whose sky you want. The years are clamped to 1900–2100.
• target_hour, target_minute - the time of day. For transits the date is the main event, but the moon's exact phase and sign can shift within a day, so it's there if you care.
• reference_city - the place. Transits are sky-wide, but the timezone resolution (and the moon-phase boundary) is location-sensitive, so you still give it a city. Needs internet - it's a live geocoder lookup.

The single output

• transit_data_json - a STRING. The natural wiring is the pack's signature move: pair it with Astro Current Date so year/month/day flow in automatically, then feed the JSON to an LLM node with a prompt like "You are a fortune teller. With these transits of the day, write a prediction." Result: a daily-horoscope pipeline that updates itself without you touching a widget.

Installing it

Standard pack install:

cd ComfyUI/custom_nodes
git clone https://github.com/Meisoftcoltd/Comfyui-Kerykeion
cd Comfyui-Kerykeion
pip install -r requirements.txt

or "ComfyUI-Kerykeion" through ComfyUI Manager, then restart. Same dependency set as the other calculators - all pip, no model files, chart math computed locally.

Common issues

• {"error": "Ciudad no encontrada..."} - the geocoder failed or the network is down. Transits are computed locally, but the location lookup isn't, so this node needs internet even though it's "offline mode" for the ephemeris.
• Geocoding throttling. Every run is a Nominatim call; if you're looping it, expect rate-limit friction.
• Only four moon phases. If you were expecting "Waxing Gibbous," you'll find "Creciente." It's a design choice for LLM consumption, not a bug.

For "what does the sky look like today, in words an AI can write horoscopes from," this is the node - and chained to Astro Current Date it stays honest about what "today" means on every single run.