¿Qué hace Asistente de Astrología IA?
Construye un asistente de astrología que calcula cartas natales con la misma lógica que herramientas profesionales (ej. Astro-Seek). Utiliza Efemérides Suizas (o pyswisseph, swephR, swisseph-js) como motor de cálculo.
Cuándo aplicar esta habilidad
- El usuario solicita el cálculo de una carta natal, carta astral u horóscopo a partir de datos de nacimiento
- Construir una API de astrología, chatbot o calculadora web
- Interpretar posiciones planetarias, casas o aspectos
- Implementar funciones astrológicas basadas en efemérides
Flujo de trabajo principal
1. Analizar datos de nacimiento (fecha, hora, lugar) → validar entradas
2. Convertir hora local → UTC → Día Juliano
3. Calcular posiciones planetarias (swe_calc_ut)
4. Calcular casas, Ascendente, MC (swe_houses)
5. Asignar planetas a casas (swe_house_pos)
6. Calcular aspectos entre todos los pares
7. Opcionalmente aplicar ayanamsha sideral
8. Formatear e interpretar resultados
Entradas requeridas
| Entrada | Obligatorio | Notas |
|---|---|---|
| Fecha de nacimiento | Sí | Día, mes, año |
| Hora | No* | Hora local (h, m, s). *Requerida para casas/Ascendente |
| Lugar de nacimiento | Sí | Nombre de ciudad o lat/long |
| Zona horaria | Sí | Automática desde ubicación o manual (ej. UTC+1) |
| Horario de verano (DST) | Sí | Observado / No observado |
| Sistema de casas | No | Por defecto: Plácido |
| Zodíaco | No | Por defecto: Tropical |
Lista de verificación de implementación
1. Conversión de hora
# Local → UTC (aplicar zona horaria + DST)
# UTC → Día Juliano
jd_ut = swe_utc_to_jd(año, mes, día, hora, min, seg, SE_GREG_CAL)
# Devuelve: dret[0]=JD_TT, dret[1]=JD_UT
2. Posiciones planetarias
# Para cada cuerpo: Sol(0), Luna(1), Mercurio(2)... Plutón(9), Nodo(10/11), Quirón(12), Lilith(15)
ret, xx = swe_calc_ut(jd_ut, id_planeta, SEFLG_SWIEPH)
# xx[0]=longitud, xx[1]=latitud, xx[2]=distancia, xx[3]=velocidad (retrógrado si < 0)
3. Casas
# Requiere: jd_ut, latitud, longitud, sistema_casas
cusps, ascmc = swe_houses(jd_ut, lat, lon, hsys)
# cusps[1..12] = cúspides de casas, ascmc[0]=Ascendente, ascmc[1]=MC
4. Asignación de casas
casa = swe_house_pos(armc, lat, oblicuidad, hsys, [lon, lat])
5. Aspectos
Calcula la distancia angular entre cada par de planetas. El aspecto es válido si |distancia - ángulo_aspecto| <= orbe.
| Aspecto | Ángulo | Orbe por defecto |
|---|---|---|
| Conjunción | 0° | 8° |
| Oposición | 180° | 7° |
| Trígono | 120° | 6° |
| Cuadratura | 90° | 6° |
| Sextil | 60° | 4° |
6. Sideral (Opcional)
swe_set_sid_mode(tipo_ayanamsha) # ej. SE_SIDM_LAHIRI
# Luego swe_calc_ut devuelve posiciones siderales
# O: lon_sideral = lon_tropical - swe_get_ayanamsa_ut(jd_ut)
Formato de salida
Presenta los resultados como:
- Tabla de planetas: Planeta | Signo | Grado | Casa | Retrógrado
- Cúspides de casas: ASC, MC, y casas 1–12
- Lista de aspectos: Planeta A – Aspecto – Planeta B (orbe)
- Puntos especiales: Parte de la Fortuna, Vértice, Nodos, Lilith (si están habilitados)
Constantes clave
- IDs de planetas: Sol=0, Luna=1, Mercurio=2, Venus=3, Marte=4, Júpiter=5, Saturno=6, Urano=7, Neptuno=8, Plutón=9, NodoMedio=10, NodoVerdadero=11, Quirón=12, LilithMedia=15
- Sistemas de casas: P=Plácido, K=Koch, R=Regiomontano, C=Campano, E=Equal, W=Signo Entero
- Signos zodiacales: 0°=Aries, 30°=Tauro, 60°=Géminis... 330°=Piscis
Parte de la Fortuna
Diurna (Sol sobre el horizonte): Fortuna = ASC + Luna - Sol
Nocturna (Sol bajo el horizonte): Fortuna = ASC + Sol - Luna
Manejo de errores
- Hora de nacimiento desconocida: Calcular carta sin casas; usar mediodía u ofrecer "carta solo por fecha"
- Coordenadas inválidas: Rechazar o usar fallback (ej. ciudad capital)
- Latitudes polares: Plácido falla; sugerir Equal o Signo Entero
- Fecha fuera de rango: Efemérides Suizas cubre ~13,000 años; validar 1800–2100 para uso típico
Dependencias
- Python:
pyswisseph+ archivos de efemérides (descargar de astro.com) - Node.js:
swissephoastronomia - R:
swephR
Configurar ruta de efemérides: swe_set_ephe_path("/ruta/a/ephe")
Referencia y ejemplos
- Especificaciones completas de API, fórmulas, ayanamshas: reference.md
- Flujos de usuario, formatos de respuesta, casos límite: examples.md