← Volver al blog
Aiaprox. 7 min de lectura

Un repo de astrología china publica 20 mil millones de caracteres. El motor es MIT. Las frases no.

Publicado 8 nov 2026
Un repo de astrología china publica 20 mil millones de caracteres. El motor es MIT. Las frases no.

El cuarto repositorio de GitHub que más crece esta semana es un proyecto en TypeScript que calcula cartas astrológicas chinas. Sumó 4,906 estrellas en siete días, lo que lo pone por encima de la mayoría de lanzamientos de modelos y por debajo de un puñado de herramientas de agentes.

El proyecto se llama ziwei-doushu, por el sistema 紫微斗数 que implementa. Se apoya en el sistema de enseñanza de Ni Haixia, un médico chino ya fallecido cuya serie de conferencias sobre el tema tiene catorce sesiones. El repositorio incluye un motor de cartas completo, los textos clásicos en sus originales de dominio público y un conjunto de datos que es la verdadera razón para mirar este repositorio.

Qué hay realmente en el conjunto de datos

La versión 4.0, publicada el 15 de octubre, contiene 674,976 cartas. Cada carta se despliega en trece dimensiones interpretativas, lo que da 8,774,688 entradas de interpretación. El texto suma unos 20.4 mil millones de caracteres, o 56.6 gigabytes descomprimidos, o 161 megabytes comprimidos y repartidos en 77 archivos por año.

Captura de una herramienta open source que muestra una carta astrológica china en una cuadrícula de celdas de colores.

El número de cartas es exhaustivo: cada fecha real del calendario entre 1950 y 2026, cruzada con doce periodos tradicionales de dos horas y con ambos sexos. El conjunto incluye un promedio de unos 30,000 caracteres de interpretación por carta.

Antes de publicar, los responsables descomprimieron los 77 archivos y los compararon byte a byte con los datos de origen. Es el tipo de nota de control de calidad que te dice que quien lo publica ya se quemó antes.

La versión anterior, la 3.0, cubría 518,400 cartas de 1924 a 1983 y se descomprimía en 33.1 gigabytes. La versión 4.0 amplió la cobertura en diecisiete años, el número de cartas en un 30 por ciento y el tamaño descomprimido en un 71 por ciento, porque el texto interpretativo de cada carta es más largo.

El motor es la parte que sobreviviría a una reescritura

El núcleo de las cartas está en `lib/ziwei/`, y la lista de funciones se lee como una lista de discusiones que los practicantes llevan décadas teniendo.

La corrección por tiempo solar verdadero ajusta la diferencia de longitud y la ecuación de tiempo, para que un nacimiento registrado en el oeste de China no se desplace un periodo completo de dos horas por culpa del reloj. Los periodos de horario de verano de China entre 1986 y 1991 se detectan, pero a propósito no se restan: la app marca el periodo y deja que el usuario confirme la lectura del reloj antes de convertir. Los meses bisiestos admiten cuatro convenciones distintas, configurables en lugar de fijadas a una escuela. La regla de la hora zi tardía cambia el día a las 23:00, y ese cambio es configurable. El brillo de las estrellas se gradúa en siete niveles, con tres niveles más gruesos reservados para la visualización, y la escuela de brillo es en sí misma un interruptor, porque los programas de cartas más usados no coinciden entre sí.

También están las cuatro transformaciones y el sistema de estrellas voladoras, doce espíritus estacionales repartidos entre la capa natal y la capa anual, y una biblioteca de patrones con más de 1,100 reglas que cubre clásicos como 紫府同宫 y 七杀朝斗.

Esto no es decoración. En un sistema donde las escuelas no se ponen de acuerdo sobre las asignaciones de brillo, fijar una sola interpretación es una decisión de producto disfrazada de detalle de implementación. Convertirlas en interruptores es lo que transforma una herramienta personal en algo que otro practicante aceptaría.

Ponerlo en marcha

El stack es Next.js 16 con App Router, TypeScript, Tailwind, Framer Motion y, debajo de la lógica de cartas, las librerías iztro y lunar-javascript.

git clone https://github.com/Renhuai123/ziwei-doushu.git
cd ziwei-doushu
npm install
cp .env.example .env.local
npm run dev

La verificación es un solo comando. `npm test` ejecuta una suite de regresión sobre 768 cartas que cubre las reglas centrales, los límites del horario de verano, el límite del inicio de la primavera, la consistencia de las muestras, los bordes del índice horario, la validez de fechas y las transformaciones dobles en el mismo palacio. La misma suite corre en GitHub Actions en cada push.

Leer una carta no necesita clave de API ni backend. El motor corre en el navegador.

El límite está trazado con una precisión poco habitual

Aquí es donde este repositorio se distingue de la mayoría de lanzamientos open source. Los responsables publicaron una lista de lo que no está incluido, con recuentos de líneas como prueba. La página de la carta tiene 75 líneas en la demo y 1,227 en el producto comercial. El panel de interpretación, 467 frente a 5,088. La cuadrícula de cartas, 285 frente a 1,334. La celda de palacio, 201 frente a 1,192. La página de compatibilidad, 368 frente a 1,937.

La biblioteca de fórmulas de interpretación, que es lo que de verdad le dice al usuario qué significa su carta, no está abierta. En el repositorio, `db-analysis.ts` es un marcador de posición. Los prompts de interpretación con IA no están abiertos. Las rutas del backend no están abiertas, y el README dice sin rodeos que configurar una clave de API no hará que `/api/interpret` funcione, porque el endpoint no existe en la versión abierta. El sistema de usuarios, el flujo de pago, la capa antiabuso y la configuración de despliegue tampoco están.

Lo que sí está abierto: el motor, los textos clásicos, un grafo de conocimiento SEO de catorce estrellas en doce palacios, la interfaz de demostración y los conjuntos de datos.

Las licencias siguen la misma lógica, en cuatro partes. El código es MIT. Los conjuntos de datos son CC BY 4.0, uso comercial permitido con atribución. Los textos clásicos son de dominio público. Las 1,848 citas transcritas de la serie de conferencias son CC BY-NC-SA 4.0, es decir, solo no comercial, y la licencia del conjunto de datos las excluye de forma explícita.

Esa última cláusula es la que conviene mirar. Veinte mil millones de caracteres de interpretación generada se pueden usar comercialmente sin coste, siempre que des atribución. Las 1,848 citas de origen de las que salieron, no.

Por qué esto es interesante más allá de la astrología

Hay tres cosas de este repositorio que se pueden generalizar.

La primera es la forma del foso. Un desarrollador solo construyó un motor de cartas, luego una base de conocimiento, luego un conjunto de datos, y abrió las partes que son caras de reconstruir y baratas de copiar, mientras se quedó con las que son baratas de escribir y difíciles de copiar: el texto interpretativo, el prompt, el embudo. Es una lectura más sofisticada de "open source" de la que logran la mayoría de las startups financiadas.

La segunda es el conjunto de datos como producto. Generar 8.7 millones de entradas de interpretación es un ejercicio de fuerza bruta en cobertura: cada fecha, cada hora, ambos sexos, trece dimensiones. Sirve para evaluar, para hacer fine-tuning, para construir un producto competidor y para cualquiera que quiera comprobar si dos interpretaciones se contradicen a lo largo de un rango completo de fechas. Publicarlo cuesta casi nada distribuirlo y compra un tipo de credibilidad que una landing page no da.

La tercera es la distribución. El README termina con una invitación a saludar en Xiaohongshu, Douyin y Xianyu, la app china de reventa. El embudo va de un repositorio de GitHub a un sitio alojado y de ahí a una cuenta social, en ese orden, y el repositorio hace el trabajo que normalmente hace un presupuesto de marketing de contenidos.

Los responsables describen el repositorio como una "instantánea abierta" más que como un producto mantenido, avisan de que las respuestas a los issues pueden tardar, y piden que quien cambie convenciones de cartas traiga una cita. Para un proyecto con 16,700 estrellas y un conjunto de datos de 56 gigabytes, es una descripción justa del trato.

Si quieres el motor, llévatelo. Si quieres las frases, las frases son el negocio.

Artículos relacionados