Implementación libre y verificable de la Proluna, la técnica de cronometría astrológica de Boris Cristoff.
Calculadora de carta natal con domificación Plácidus, aspectario y el punto Proluna del día. Software libre bajo AGPL-3.0.
Ver funcionando en astro.com.uy · La técnica explicada · Instalación
La Proluna se usa desde hace más de cincuenta años y no existe una implementación pública que explique cómo se calcula. Hay calculadoras que devuelven un resultado y piden que se les crea.
Este repositorio publica el método y el código, para que cualquier astrólogo —con la ayuda de alguien de sistemas— pueda montarlo en su propia práctica, verificarlo, corregirlo o llevarlo a otro lenguaje.
La astrología tiende a la torre de Babel: cada quien guarda su técnica como un tesoro para que nadie más la use. La idea acá es exactamente la contraria, y era también la de Cristoff, que enseñó Proluna abiertamente cuando lo esperable en su medio era reservarla para discípulos.
La especificación técnica es autosuficiente: alcanza para implementar la técnica correctamente desde cero, sin comprar nada.
- Carta natal — posiciones planetarias, doce cúspides Plácidus, Ascendente y Medio Cielo, aspectos mayores con orbes, rueda dibujada en SVG.
- Punto Proluna del día — dónde está hoy el nativo en su propio ciclo de 84 años, marcado sobre la rueda.
- Cinta de tránsitos — Sol y Luna para los próximos días.
- Buscador de ciudades — nombre del lugar a coordenadas y zona horaria (opcional).
La vida se recorre en un ciclo de 84 años dividido en doce edades septenales, una por casa, empezando en el Ascendente. Cada casa dura exactamente siete años: la II empieza a los 7, la III a los 14, la VII a los 42, y a los 84 el punto vuelve al Ascendente.
Lo que distingue a la Proluna de una progresión lineal es que el punto avanza proporcionalmente al arco real de cada casa. Como Plácidus produce casas de tamaño desigual, una casa de 40° y otra de 20° contienen los mismos siete años de vida, y el punto se mueve al doble de velocidad en la primera. Un modelo que avanzara 4,29° por año no sería Proluna.
El detalle completo, con los casos límite y cómo verificar una implementación, está en docs/proluna-tecnica.md.
src/ Núcleo. Lógica pura, sin entrada/salida.
Proluna.php ← el cálculo de la técnica
Zodiaco.php longitudes ↔ signos, grados, minutos
Aspectos.php aspectario mayor
Efemerides.php adaptador de Swiss Ephemeris (única frontera externa)
public/ Lo que se sirve por web
index.html la interfaz
api/ endpoints delgados: validan, orquestan, serializan
assets/ estilos, scripts de dibujo, iconos
tests/run.php 35 pruebas. Se ejecutan sin instalar nada.
ports/ el núcleo traducido a Python y JavaScript
docs/ la técnica y la instalación
tools/ scripts de instalación
Si solo te interesa la técnica, el archivo es
src/Proluna.php. Son unas cuarenta líneas de aritmética
sin dependencias. Todo lo demás es andamiaje.
Requiere PHP 8.1 o superior con exec() habilitado, y un compilador de C para
Swiss Ephemeris.
git clone https://github.com/alvaroarta/Proluna.git
cd Proluna
bash tools/instalar_sweph.sh # descarga y compila Swiss Ephemeris
php tests/run.php # verifica el núcleo
php -S localhost:8000 -t public # servidor de pruebaEl buscador de ciudades necesita MySQL y es opcional:
cp config/db_config.example.php config/db_config.php
# editar con tus credenciales
bash tools/importar_geonames.shSin él, la calculadora funciona pidiendo latitud, longitud y zona horaria a mano. El pormenor está en docs/instalacion.md.
php tests/run.php # 35 pruebas del núcleo
python3 ports/proluna.py # autoprueba del port de Python
node ports/proluna.mjs # autoprueba del port de JavaScriptLas pruebas cubren los bordes donde esta aritmética se rompe: cruces de 0° Aries, la casa XII cerrando sobre el Ascendente, la segunda vuelta después de los 84 años, límites exactos de cúspide, e inmunidad al horario de verano.
Los tres lenguajes fueron contrastados sobre 500 cartas aleatorias: coinciden con desvío 0. Si portás la técnica a otro lenguaje, esos son los casos contra los que conviene verificar.
El núcleo no depende de PHP ni de Swiss Ephemeris: recibe las doce cúspides ya calculadas, vengan de donde vengan.
from proluna import calcular
r = calcular(cuspides, nacimiento, datetime.now(tz))
print(r["longitude"], r["house_current"])ports/proluna.py y
ports/proluna.mjs son traducciones literales, con
autoprueba incluida. Sirven de referencia para cualquier otro lenguaje.
Para reemplazar el motor de efemérides —por pyswisseph, por el paquete
swisseph de npm, por una compilación WASM— alcanza con sustituir
src/Efemerides.php. Es la única pieza que toca el
mundo exterior.
Algunas decisiones son metodológicas y no consenso astrológico. Están explícitas para que puedas discreparlas con fundamento:
- Plácidus es obligatorio. Con casas iguales el avance proporcional se vuelve lineal y se pierde lo que caracteriza al método.
- Plutón no se aspecta. Se calcula y se muestra, pero su latitud eclíptica excede con frecuencia el rango operativo del aspectario clásico.
- El Nodo Norte no se aspecta. Es un punto matemático de intersección, no un cuerpo emisor ni receptor de influencias.
- El año es de 365,25 días, no calendario real. Es el valor con el que la técnica se viene aplicando; cambiarlo desplazaría el punto respecto de décadas de práctica.
- La fecha evaluada es siempre hoy. La Proluna se lee en vivo sobre la carta montada. El núcleo acepta cualquier momento, pero la interfaz no lo expone.
Las dos exclusiones se revierten pasando una lista vacía a
Aspectos::aspectar().
AGPL-3.0-or-later. Ver LICENSE y NOTICE.
Podés usar, estudiar, modificar y redistribuir este software. Si lo modificás y lo ofrecés como servicio en red, tenés que publicar tu código fuente bajo la misma licencia.
La razón de que sea AGPL y no MIT es la Swiss Ephemeris, que se distribuye bajo doble licencia AGPL/comercial; este proyecto se acoge a la vía AGPL, lo que obliga a que todo derivado sea igualmente libre. Para uso propietario hay que licenciar Swiss Ephemeris con Astrodienst, o reemplazar el motor de efemérides.
Que la licencia empuje en la dirección de mantener esto abierto es, en este caso, un acierto.
La técnica es de Boris Cristoff (Bulgaria, 1925 — Uruguay). Corresponde reconocerle el padrinazgo más que la paternidad: el septenario y la estructura domal ya existían en la tradición rosacruz, y lo que él hizo fue compactarlos en una herramienta de consulta y difundirla. Los detalles están en NOTICE.
Implementación y testimonio: Alvaro Artagaveytia, que conoció, discutió y evaluó la técnica con el propio Cristoff, y la aplica en consulta desde hace más de cuarenta años.
Cálculo astronómico: Swiss Ephemeris (Astrodienst AG). Datos geográficos: GeoNames (CC BY 4.0).
Hasta hace unos cuarenta años, levantar una carta natal era un trabajo de álgebra: efemérides impresas, tablas de casas, interpolación, logaritmos. Una revolución solar llevaba una tarde. Ese era el método obligatorio, no una opción pintoresca.
Quienes aprendimos así quedamos pocos, y somos los últimos que podemos construir una carta sin una computadora. Un astrólogo formado después de los años noventa no puede ejercer sin software: no es una crítica, es una constatación. La herramienta dejó de ser un accesorio y pasó a ser la condición de la práctica.
De ahí sale el problema que este repositorio intenta atacar. Si el software es la condición de la práctica, entonces quien controla el software controla la práctica. Una comunidad que no programa queda atrapada en lo que otros deciden ofrecerle, al precio que decidan, con las técnicas que decidan incluir —y la Proluna, que se usa en consulta desde hace medio siglo, no está incluida en casi ninguna parte.
La respuesta no es volver a los logaritmos. Es que las técnicas estén publicadas, explicadas y en código que cualquiera pueda leer, verificar y correr en su propia máquina. Un astrólogo que no programa igual puede pedirle a alguien de sistemas que le monte esto: son unas pocas horas de trabajo, y está todo documentado para eso.
El cálculo a mano se perdió. Que además se pierda el control sobre el cálculo no era inevitable.
Este repositorio cubre el cálculo. La interpretación —qué significa el punto en consulta, los casos, el criterio de lectura— y la historia completa de la técnica están en:
- Proluna según Boris Cristoff, con ampliaciones — Amazon
- artagaveytia.com
El libro es un testimonio: con la desaparición de los actores originales la historia de la Proluna se ha ido deformando en internet, y quedan pocas personas que la hayan discutido con Cristoff directamente.
Correcciones, ports a otros lenguajes y mejoras son bienvenidos. Ver CONTRIBUTING.md.
Si encontrás una discrepancia entre esta implementación y la técnica tal como la conociste, abrí un issue: ese tipo de corrección es justamente lo que hace que valga la pena tener esto público.