Un motor de astrología con 1.100 reglas que está mejor construido que la mayoría de los productos de IA

Un repositorio en TypeScript para calcular cartas astrológicas chinas tiene 16.868 estrellas en GitHub esta semana. Es más de lo que consiguen la mayoría de las herramientas para desarrolladores en toda su vida, y para un tema que la mayoría de los ingenieros occidentales archivarían en «no es software».
Lo interesante no es el tema. Es que el repositorio está mejor construido que buena parte de lo que se publica con la etiqueta «producto de IA».
ziwei-doushu es un motor open source de 紫微斗数 —astrología de la Estrella Púrpura— basado en el sistema que enseñaba 倪海厦 en sus conferencias 天纪. Las cartas se calculan por completo en el navegador. No hay clave de API, ni modelo, ni inferencia. Es aritmética, tablas de consulta y 1.100 líneas de reglas de patrones.
Y viene con 768 cartas de regresión.
Qué calcula en realidad
Si no se conoce el dominio, la tabla de capacidades del README sirve también como lista de las formas en que este tipo de cálculo se estropea.
Corrección del tiempo solar verdadero. Una hora de nacimiento registrada en un reloj no es la hora solar de ese lugar. El motor corrige la diferencia de longitud más la ecuación del tiempo, para que una carta levantada en el este del país no caiga una doble hora desviada. Es el equivalente astrológico de un error de zona horaria, y es lo primero que se rompe en las implementaciones ingenuas.
El horario de verano chino, de 1986 a 1991. El país aplicó horario de verano durante seis años y luego lo dejó. El motor detecta el intervalo pero deliberadamente no resta la hora de forma automática: el README es explícito en que las lecturas de reloj las confirma el usuario y luego se convierten mediante un clock-adjust.ts aparte. Es un instinto correcto. Ajustar en silencio la entrada del usuario es cómo se producen cartas equivocadas con seguridad.
Cuatro convenciones para los meses bisiestos. Las escuelas no se ponen de acuerdo en si un mes bisiesto pertenece al mes anterior, al siguiente, se parte por días o cuenta como propio. El motor lo convierte en un ajuste en lugar de tomar partido. Lo mismo con el brillo de las estrellas, donde distintas tradiciones —y distintas versiones del mismo programa comercial— usan escalas diferentes. Se soportan siete niveles, con una clasificación más gruesa de tres niveles como respaldo de visualización.
Cambio de día en la hora zi tardía. De 23:00 a 23:59 se trata como el día siguiente; de 00:00 a 00:59, como el día actual. Si se proporciona el lugar de nacimiento, el juicio se hace sobre el tiempo solar verdadero para que las dos reglas sean coherentes.
Encima de eso están las cuatro transformaciones y las estrellas voladoras, doce colocaciones de espíritus y muertes que cambian entre la capa natal y la anual, y una biblioteca de patrones de más de 1.100 reglas: 紫府同宫, 日月并明, 七杀朝斗 y el resto.

Los tests son el argumento
Cualquiera puede afirmar que su motor de cartas es correcto. Este publica una suite de pruebas que se ejecuta en cada push y cada pull request, y la lista de lo que comprueba es la parte más informativa del repositorio:
768 cartas contra las reglas de hierro del sistema. Los intervalos de horario de verano. El límite de 立春, donde cambia el año en este calendario y donde casi todas las implementaciones tienen un error de uno. La colocación de 红鸾 y 天喜. La coherencia del índice horario en las cartas de muestra. Las condiciones de contorno del índice horario. La validez de las fechas. El caso en que dos transformaciones caen en el mismo palacio.
Esa no es una lista de marketing. Es una lista escrita por alguien a quien cada punto le mordió por turnos. Solo el límite de 立春 rompe una implementación ingenua todos los años para cualquiera nacido en la primera semana de febrero.
Instalarlo
Tres comandos:
git clone https://github.com/Renhuai123/ziwei-doushu.git
cd ziwei-doushu
npm install
Opcionalmente cp .env.example .env.local, y luego npm run dev. La verificación es npm run typecheck para una pasada completa de TypeScript y npm test para la suite de regresión del motor de cartas.
No hace falta clave de API para levantar ni mostrar una carta, ni para la carta de compatibilidad. Todo corre en el cliente, que es la decisión correcta para algo construido a partir de una fecha y un lugar de nacimiento.
El límite que puso el autor, y por qué es lo más honesto del README
La versión open source no incluye las rutas de API del backend. El cálculo de cartas, la visualización y el cálculo de compatibilidad son locales. Pero el endpoint de interpretación con IA —/api/interpret— y el de análisis de compatibilidad no están implementados.
Sin ellos, la interfaz dice, sin rodeos, que la versión open source no incluye ese endpoint. Y el README añade una línea que resuelve un problema que la gente seguía reportando: configurar una clave de API no hará que esas funciones funcionen. La issue #30 existe porque los usuarios asumían lo contrario.
Es una decisión poco habitual. Lo fácil sería publicar un stub que llame a un modelo y produzca comentarios verosímiles. En cambio el repositorio es una calculadora que se niega a fingir que es un oráculo. Dado cuánto de la presencia online de este tema es tontería segura de sí misma, una herramienta que se detiene en el borde de lo que puede calcular merece atención.
Los nombres, y por qué se lee como una biblioteca
El código está organizado según cómo se enseña de verdad la disciplina, y por eso es legible.
lib/ziwei/algorithm.ts contiene la secuencia de cálculo: colocar el palacio de la vida, determinar el 局 de los cinco elementos, colocar las catorce estrellas mayores, colocar las estrellas auxiliares, disponer los ciclos de década y anuales. constants.ts contiene los troncos, las ramas y las listas de estrellas. sihua.ts contiene las cuatro transformaciones —禄, 权, 科, 忌—, incluidos los casos de autotransformación de las estrellas voladoras. Luego hay módulos separados para la biblioteca de patrones y las tablas de brillo.
Si se conoce el tema, ese mapeo es obvio. Si no, sigue siendo legible: constantes, luego aritmética, luego reglas, luego datos cercanos a la interpretación. El dominio es desconocido y la estructura no, que es el aspecto del buen software cuando lo construye alguien que entiende la materia y no la tendencia.
La elección de TypeScript también importa. Las cartas son un árbol de palacios con estrellas en cada uno, transformadas por reglas que se referencian entre sí. Un sistema de tipos que puede expresar «un palacio contiene una lista de estrellas, cada una con un nivel de brillo de un conjunto fijo» atrapa toda una clase de errores en tiempo de compilación, y el repositorio ejecuta un typecheck completo antes que nada. Para un dominio con tantos valores enumerados, eso no es decoración.
Por qué un blog de IA escribe sobre un motor de astrología
Porque es el contraejemplo limpio de cómo se construyen ahora la mayoría de los productos de IA.
Aquí hay un sistema donde cada salida es determinista, cada regla es atribuible a una tradición con nombre, cada convención ambigua es un interruptor de configuración y no una opinión, y la corrección se impone con 768 casos de regresión. Se le pregunta dos veces y da la misma respuesta. No hay alucinación, porque no hay generación.
Luego está la parte que explícitamente no hace: interpretar. La capa de interpretación —la que requiere criterio y donde distintos practicantes discreparán— se deja al usuario o a un endpoint implementado aparte.
A la mayoría de los equipos que construyen con modelos de lenguaje les vendría bien copiar esa separación. Calcular lo que se puede calcular, con exactitud, y ser explícito sobre dónde empieza la interpretación. La alternativa es un sistema que suena autoritativo sobre la diferencia entre las dos cosas, que es justo el modo de fallo que este repositorio se diseñó para evitar.
El código es MIT. El conjunto de datos es CC BY 4.0. Los textos clásicos son de dominio público. Las palabras del profesor tienen licencia no comercial, y el README lo dice. Todo está documentado, lo que es más de lo que consiguen la mayoría de los proyectos con material mucho menos polémico.
No hace falta creer en el tema para aprender algo de la ingeniería. Esa suele ser la marca de una cosa bien hecha.
Artículos relacionados
La regla de exportación ya no apunta al chip, sino al cliente
La norma no prohíbe chips: prohíbe el anonimato. Y mueve la unidad de control del hardware a la relación con el cliente final.
La noticia de Nvidia no fue el informe: fue el comité
En nueve días el consejo produjo una investigación, una presidencia y un comité de cumplimiento. No es control del calendario: es reacción.
Nvidia tuvo que ponerle precio a su fundador
En nueve días, Nvidia cambió de CEO y de consejo sin perder un trimestre. El mercado, mientras tanto, le puso precio a lo que valía un solo hombre.
Una hoja de cálculo comunitaria de toques que apaga la publicidad de los Android chinos
No toca el sistema, no desbloquea nada, no flashea nada. Solo mueve los interruptores que los fabricantes ya dejaron a la vista. El precio es una lista que alguien tiene que seguir escribiendo.