AI Astrology Assistant
Build an astrology assistant that computes birth charts with the same logic as professional tools (e.g. Astro-Seek). Use Swiss Ephemeris (or pyswisseph, swephR, swisseph-js) as the calculation engine.
When to Apply This Skill
- User asks for birth chart calculation, natal chart, or horoscope by birth data
- Building an astrology API, chatbot, or web calculator
- Interpreting planetary positions, houses, or aspects
- Implementing ephemeris-based astrology features
Core Workflow
1. Parse birth data (date, time, location) → validate inputs
2. Convert local time → UTC → Julian Day
3. Compute planetary positions (swe_calc_ut)
4. Compute houses, Ascendant, MC (swe_houses)
5. Assign planets to houses (swe_house_pos)
6. Calculate aspects between all pairs
7. Optionally apply sidereal ayanamsha
8. Format and interpret results
Required Inputs
| Input |
Required |
Notes |
| Date of birth |
Yes |
Day, month, year |
| Time |
No* |
Local time (h, m, s). *Required for houses/Ascendant |
| Birth place |
Yes |
City name or lat/long |
| Timezone |
Yes |
Auto from location or manual (e.g. UTC+1) |
| DST |
Yes |
Observed / Not-Observed |
| House system |
No |
Default: Placidus |
| Zodiac |
No |
Default: Tropical |
Implementation Checklist
1. Time Conversion
# Local → UTC (apply timezone + DST)
# UTC → Julian Day
jd_ut = swe_utc_to_jd(year, month, day, hour, min, sec, SE_GREG_CAL)
# Returns: dret[0]=JD_TT, dret[1]=JD_UT
2. Planetary Positions
# For each body: Sun(0), Moon(1), Mercury(2)... Pluto(9), Node(10/11), Chiron(12), Lilith(15)
ret, xx = swe_calc_ut(jd_ut, planet_id, SEFLG_SWIEPH)
# xx[0]=longitude, xx[1]=latitude, xx[2]=distance, xx[3]=speed (retrograde if < 0)
3. Houses
# Requires: jd_ut, latitude, longitude, house_system
cusps, ascmc = swe_houses(jd_ut, lat, lon, hsys)
# cusps[1..12] = house cusps, ascmc[0]=Ascendant, ascmc[1]=MC
4. House Assignment
house = swe_house_pos(armc, lat, obliquity, hsys, [lon, lat])
5. Aspects
Compute angular distance between each planet pair. Aspect is valid if |distance - aspect_angle| <= orb.
| Aspect |
Angle |
Default orb |
| Conjunction |
0° |
8° |
| Opposition |
180° |
7° |
| Trine |
120° |
6° |
| Square |
90° |
6° |
| Sextile |
60° |
4° |
6. Sidereal (Optional)
swe_set_sid_mode(ayanamsha_type) # e.g. SE_SIDM_LAHIRI
# Then swe_calc_ut returns sidereal positions
# Or: sidereal_lon = tropical_lon - swe_get_ayanamsa_ut(jd_ut)
Output Format
Present results as:
- Planet table: Planet | Sign | Degree | House | Retrograde
- House cusps: ASC, MC, and houses 1–12
- Aspects list: Planet A – Aspect – Planet B (orb)
- Special points: Part of Fortune, Vertex, Nodes, Lilith (if enabled)
Key Constants
- Planet IDs: Sun=0, Moon=1, Mercury=2, Venus=3, Mars=4, Jupiter=5, Saturn=6, Uranus=7, Neptune=8, Pluto=9, MeanNode=10, TrueNode=11, Chiron=12, MeanLilith=15
- House systems: P=Placidus, K=Koch, R=Regiomontanus, C=Campanus, E=Equal, W=Whole Sign
- Zodiac signs: 0°=Aries, 30°=Taurus, 60°=Gemini... 330°=Pisces
Part of Fortune
Diurnal (Sun above horizon): Fortune = ASC + Moon - Sun
Nocturnal (Sun below horizon): Fortune = ASC + Sun - Moon
Error Handling
- Unknown birth time: Compute chart without houses; use noon or offer "chart for date only"
- Invalid coordinates: Reject or use fallback (e.g. capital city)
- Polar latitudes: Placidus fails; suggest Equal or Whole Sign
- Date out of range: Swiss Ephemeris covers ~13,000 years; validate 1800–2100 for typical use
Dependencies
- Python:
pyswisseph + ephemeris files (download from astro.com)
- Node.js:
swisseph or astronomia
- R:
swephR
Set ephemeris path: swe_set_ephe_path("/path/to/ephe")
Reference & Examples
- Full API specs, formulas, ayanamshas: reference.md
- User flows, response formats, edge cases: examples.md
1---2name: astrology-assistant3description: Build and operate an AI astrology assistant that calculates birth charts, planetary positions, houses, and aspects using Swiss Ephemeris logic. Use when creating natal charts, birth chart calculators, astrology APIs, horoscope bots, or interpreting planetary positions.4---56# AI Astrology Assistant78Build an astrology assistant that computes birth charts with the same logic as professional tools (e.g. Astro-Seek). Use **Swiss Ephemeris** (or pyswisseph, swephR, swisseph-js) as the calculation engine.910## When to Apply This Skill1112- User asks for birth chart calculation, natal chart, or horoscope by birth data13- Building an astrology API, chatbot, or web calculator14- Interpreting planetary positions, houses, or aspects15- Implementing ephemeris-based astrology features1617---1819## Core Workflow2021```221. Parse birth data (date, time, location) → validate inputs232. Convert local time → UTC → Julian Day243. Compute planetary positions (swe_calc_ut)254. Compute houses, Ascendant, MC (swe_houses)265. Assign planets to houses (swe_house_pos)276. Calculate aspects between all pairs287. Optionally apply sidereal ayanamsha298. Format and interpret results30```3132---3334## Required Inputs3536| Input | Required | Notes |37|-------|----------|-------|38| Date of birth | Yes | Day, month, year |39| Time | No* | Local time (h, m, s). *Required for houses/Ascendant |40| Birth place | Yes | City name or lat/long |41| Timezone | Yes | Auto from location or manual (e.g. UTC+1) |42| DST | Yes | Observed / Not-Observed |43| House system | No | Default: Placidus |44| Zodiac | No | Default: Tropical |4546---4748## Implementation Checklist4950### 1. Time Conversion5152```python53# Local → UTC (apply timezone + DST)54# UTC → Julian Day55jd_ut = swe_utc_to_jd(year, month, day, hour, min, sec, SE_GREG_CAL)56# Returns: dret[0]=JD_TT, dret[1]=JD_UT57```5859### 2. Planetary Positions6061```python62# For each body: Sun(0), Moon(1), Mercury(2)... Pluto(9), Node(10/11), Chiron(12), Lilith(15)63ret, xx = swe_calc_ut(jd_ut, planet_id, SEFLG_SWIEPH)64# xx[0]=longitude, xx[1]=latitude, xx[2]=distance, xx[3]=speed (retrograde if < 0)65```6667### 3. Houses6869```python70# Requires: jd_ut, latitude, longitude, house_system71cusps, ascmc = swe_houses(jd_ut, lat, lon, hsys)72# cusps[1..12] = house cusps, ascmc[0]=Ascendant, ascmc[1]=MC73```7475### 4. House Assignment7677```python78house = swe_house_pos(armc, lat, obliquity, hsys, [lon, lat])79```8081### 5. Aspects8283Compute angular distance between each planet pair. Aspect is valid if `|distance - aspect_angle| <= orb`.8485| Aspect | Angle | Default orb |86|--------|-------|-------------|87| Conjunction | 0° | 8° |88| Opposition | 180° | 7° |89| Trine | 120° | 6° |90| Square | 90° | 6° |91| Sextile | 60° | 4° |9293### 6. Sidereal (Optional)9495```python96swe_set_sid_mode(ayanamsha_type) # e.g. SE_SIDM_LAHIRI97# Then swe_calc_ut returns sidereal positions98# Or: sidereal_lon = tropical_lon - swe_get_ayanamsa_ut(jd_ut)99```100101---102103## Output Format104105Present results as:1061071. **Planet table**: Planet | Sign | Degree | House | Retrograde1082. **House cusps**: ASC, MC, and houses 1–121093. **Aspects list**: Planet A – Aspect – Planet B (orb)1104. **Special points**: Part of Fortune, Vertex, Nodes, Lilith (if enabled)111112---113114## Key Constants115116- **Planet IDs**: Sun=0, Moon=1, Mercury=2, Venus=3, Mars=4, Jupiter=5, Saturn=6, Uranus=7, Neptune=8, Pluto=9, MeanNode=10, TrueNode=11, Chiron=12, MeanLilith=15117- **House systems**: P=Placidus, K=Koch, R=Regiomontanus, C=Campanus, E=Equal, W=Whole Sign118- **Zodiac signs**: 0°=Aries, 30°=Taurus, 60°=Gemini... 330°=Pisces119120---121122## Part of Fortune123124```125Diurnal (Sun above horizon): Fortune = ASC + Moon - Sun126Nocturnal (Sun below horizon): Fortune = ASC + Sun - Moon127```128129---130131## Error Handling132133- **Unknown birth time**: Compute chart without houses; use noon or offer "chart for date only"134- **Invalid coordinates**: Reject or use fallback (e.g. capital city)135- **Polar latitudes**: Placidus fails; suggest Equal or Whole Sign136- **Date out of range**: Swiss Ephemeris covers ~13,000 years; validate 1800–2100 for typical use137138---139140## Dependencies141142- **Python**: `pyswisseph` + ephemeris files (download from astro.com)143- **Node.js**: `swisseph` or `astronomia`144- **R**: `swephR`145146Set ephemeris path: `swe_set_ephe_path("/path/to/ephe")`147148---149150## Reference & Examples151152- **Full API specs, formulas, ayanamshas:** [reference.md](reference.md)153- **User flows, response formats, edge cases:** [examples.md](examples.md)154
anna-oya-ai