¿Qué es la Cosmobiology de Ebertin?

Cosmobiology es un método astrológico del siglo XX desarrollado por Reinhold Ebertin en Alemania. Reduce la interpretación de cartas a aspectos duros (conjunción, oposición, cuadratura, semicuadratura, sesquicuadratura) leídos en un dial de 22,5° — la 4ª armónica del zodíaco. Los puntos medios y las efemérides gráficas son herramientas centrales. Cosmobiology enfatiza el timing y la predicción de eventos sobre la lectura psicológica. El endpoint graphic-ephemeris te da la visualización que los practicantes de Cosmobiology han usado desde Combination of Stellar Influences de Ebertin (1940).

¿Por qué la 4ª armónica 22,5° es el estándar?

360° dividido entre 16 es igual a 22,5°. La 4ª armónica saca a la luz cada aspecto duro: conjunción (0°), semicuadratura (45°), cuadratura (90°), sesquicuadratura (135°) y oposición (180°) todos colapsan sobre la misma rejilla 22,5° porque cada uno es múltiplo de 22,5°. Los aspectos blandos (trígono, sextil) no. Eso hace del dial 22,5° un detector de aspectos duros — por eso Cosmobiology lo adoptó como estándar de facto para trabajo de timing. graphic-ephemeris hace default a harmonic=4 por esa razón.

¿Las capas SVG tienen nombre para estilado downstream?

Sí. Cada endpoint /render/* agrupa elementos SVG en capas con nombre: g id='axes', g id='aspects', g id='planets' en la rueda; g id='bars', g id='ticks', g id='axis' en Gantt de tránsitos; g id='planet-sun', g id='planet-moon', etc. en graphic-ephemeris. Tu CSS o procesador SVG downstream puede apuntar a cualquier capa por id sin parsear geometría — recolorear planetas, ocultar la capa de aspectos, restilar ticks. La convención de nombrado se mantiene estable entre versiones.

¿Qué temas de carta están disponibles?

Cuatro presets: minimal (claro limpio), minimal-dark (papel oscuro limpio), astrocom (versión clara del look de astro.com) y astrocom-dark (versión oscura del look de astro.com). Por debajo, también funcionan cuatro temas CSS nativos de Kerykeion: light, dark, dark-high-contrast, classic. Pasa theme=astrocom-dark para el look profesional oscuro más popular. Cada preset se monta sobre un tema CSS base de Kerykeion, así que los colores de papel y los sectores de zodíaco heredan limpiamente.

¿Puedo conseguir una carta estilo Astrocom?

Sí — pon theme=astrocom (claro) o theme=astrocom-dark. Esto combina cuatro parches a la vez: axis_stroke_width=3.0 para líneas AC/MC/DC/IC gruesas, axes_labels_position='outside' para etiquetas justo fuera de la rueda, house_numbers_position='center' para el layout de números de casas en anillo interior, y un axis_color unificado (#444444 claro, #6b7280 oscuro). El output imita la carta de referencia de astro.com (Astrodienst) que los astrólogos tradicionales llevan 30+ años leyendo.

¿Cómo personalizo el grosor de los ejes?

Pasa axis_stroke_width como float. 1.0 es el default (comportamiento de Kerykeion pre-parche). 3.0 coincide con el preset astrocom y la referencia de astro.com. 5.0+ funciona para output de póster. El parámetro solo afecta a las cuatro cúspides de eje (AC en índice 0, IC en 3, DC en 6, MC en 9). Las otras cúspides de casas se quedan en 1px discontinuo a opacidad 0.4. Las líneas de eje renderizan sólidas a opacidad 0.9 cuando se setea este parámetro.

¿Puedo ocultar planetas específicos de las líneas de aspectos?

Sí — pasa hide_points_in_aspects como array de nombres, p. ej. ['Chiron','Mean_Lilith','Mean_South_Node']. Esos puntos se quedan visibles en la rueda pero el post-procesador los quita de cada línea de aspecto del SVG y elimina su fila de la cuadrícula. Útil para embeds donde quieres una vista de aspectos limpia sin sacar los cuerpos menores de la carta entera. El post-procesador corre después de makeTemplate() de Kerykeion, así que el timing es consistente.

¿La API renderiza la Parte de la Fortuna?

Sí. Añade 'part_of_fortune' a active_points y pasan tres cosas: la fórmula día/noche calcula la posición (ASC + Luna - Sol para cartas de día, ASC + Sol - Luna para noche), el glifo de cruz en círculo renderiza en la rueda vía el nuevo símbolo Part_of_Fortune en las defs del SVG, y aparece una fila de Parte de la Fortuna en la cuadrícula de aspectos. Calculamos los aspectos de la Parte de la Fortuna nosotros porque Kerykeion upstream no sabe que el cuerpo existe. Funciona hoy para tipos natal y external-natal.

¿Soportan planetas uranianos / Escuela de Hamburgo?

Sí — los ocho hipotéticos uranianos renderizan nativamente: Cupido, Hades, Zeus, Kronos, Apollon, Admetos, Vulcanus, Poseidón. Añade los nombres que quieras a active_points y el settings_builder inyecta el glifo y config de color de cada uno. Aparecen en la rueda y en la cuadrícula de aspectos como cualquier otro cuerpo. Combina con hide_points_in_aspects para dibujar los glifos sin el ruido de aspectos, que casa con el estilo de notación de la Escuela de Hamburgo.

¿Puedo renderizar cartas de sinastría, tránsitos y compuestas?

Sí — un endpoint, cuatro tipos de carta: Natal, Sinastría, Tránsitos, Compuesta. El sistema de temas aplica a todos, así que theme=astrocom-dark te da una carta de sinastría estilo astrocom oscuro con los nombres de ambos sujetos en la cabecera de doble carta. Los sujetos secundarios de sinastría y tránsitos también reciben los números de casas parcheados y (cuando se configura) su propio glifo de Parte de la Fortuna. Los aspectos cruzados de Parte de la Fortuna están en el roadmap.

¿Por qué vendorizaron Kerykeion v4.26.3 en vez de solo importarlo?

Importar Kerykeion vía pip significaba que no podíamos cambiar el comportamiento de ejes, añadir Parte de la Fortuna, ni parchear la lógica de aspectos sin forkear. Copiamos Kerykeion v4.26.3 a app/vendor/kerykeion_charts/, mantuvimos los paths de import compatibles, y añadimos un PATCHES.md que trackea cada cambio. Ahora los upgrades upstream son una revisión de código deliberada en vez de un breaking change silencioso en producción. Cada parche tiene una etiqueta numerada (PATCH-01 a PATCH-04 más PATCH-PartOfFortune) y un comentario inline en el código.

¿Dónde van los números de casas con house_numbers_position='center'?

Los números de casas renderizan en un anillo interior al 78% del radio de la rueda (r * 0.78), usando fuente 10px con fill-opacity 0.7. Este es el layout de astro.com. El default ('near_cusp' o null) los mantiene en el offset dropin original junto a cada cúspide con fuente 14px y fill-opacity 0.6. Para cartas de sinastría y tránsitos, el mismo encogimiento aplica a los números del sujeto secundario — la lógica de fill-opacity específica de tránsitos (0 para tránsito, 0.4 si no) se preserva.

¿Qué hace hide_axes_visually?

Pasa un array de nombres de eje (p. ej. ['IC','DC']) y esas líneas de eje se quitan del SVG, mientras los cálculos subyacentes se quedan intactos. Los ángulos siguen en los datos de la carta, así que los cálculos de aspectos y las posiciones de casas siguen siendo correctos — solo desaparece la línea visible. Útil para embeds minimalistas donde quieres mostrar planetas y signos sin la cruz de ejes cardinales. Esto es actualmente un post-procesador a nivel stub; el control completo por eje está en el roadmap.

¿Cuánto tarda el render?

El tiempo de render típico se mantiene bajo 500ms, peor caso bajo 1 segundo. El path de código de Kerykeion vendorizado añade overhead mínimo — los parches son sobre todo ramas condicionales en funciones de dibujo existentes más un pase de post-procesador sobre el string SVG. El tiempo de cold-start depende de la carga de archivos Swiss Ephemeris. El edge caching cubre requests idénticos, así que la generación repetida para los mismos datos de nacimiento vuelve casi instantánea.

¿Qué formatos de salida obtengo?

SVG es la salida principal — todo lo que hace el renderer es nativo SVG. PNG, JPEG, WebP y PDF están disponibles a través de endpoints de conversión de formato. SVG es lo que quieres para embeds web porque escala sin pérdida de calidad y es pequeño. Usa PNG o JPEG cuando necesites compatibilidad con clientes de email (Outlook). PDF preserva calidad vectorial para impresión. WebP es aproximadamente 30% más pequeño que PNG con la misma calidad visual.

¿Puedo sobreescribir settings de tema por request?

Sí — pasa un dict custom_settings para sobreescribir cualquier setting de carta sobre el tema. El merge es superficial: los defaults del tema cargan primero, tu dict custom_settings sobreescribe encima, el resultado va a Kerykeion. También puedes pasar params de parche individuales (axis_stroke_width, axes_labels_position, etc.) directamente — estos siempre ganan sobre los defaults del tema. Un tema es un punto de partida, no una restricción.

¿Cuánto cuesta la API de Renderizado de Cartas?

El renderizado de cartas cuesta 10 créditos por request. El plan Ultra empieza en $37/mes por 55.000 créditos (unas 5.500 cartas). El plan Business es $99/mes por 220.000 créditos (unas 22.000 cartas). El nivel gratuito no incluye renderizado de cartas — solo endpoints de datos. Los planes Enterprise reciben infraestructura dedicada y generación ilimitada.

¿Qué sistemas de casas están soportados?

23 sistemas de casas funcionan con cada tema y cada tipo de carta: Placidus, Whole Sign, Equal House, Koch, Regiomontanus, Campanus, Morinus, Porphyry, Topocéntrico, Alcabitius, Krusinski, Sripati, y 11 más. La elección de sistema de casas es independiente del tema — puedes renderizar una carta Whole Sign en el tema astrocom-dark y las cúspides dibujan correctamente. Los cálculos usan Swiss Ephemeris (datos NASA JPL).

¿Cuán precisos son los cálculos subyacentes?

Precisión sub-arcosegundo para cada planeta, asteroide y cuerpo hipotético. El renderer es una capa fina sobre Swiss Ephemeris, que usa datos de efemérides NASA JPL — la misma fuente en la que se apoya el software astronómico profesional. Los parámetros de tema y personalización solo afectan al output visual; las matemáticas son idénticas sin importar qué tema elijas.

¿Hay ruedas de timing (age-bands, bi-wheel)?

Sí — las ruedas SVG de timing viven en /svg/timing/* como endpoints separados. La rueda de age-bands renderiza anillos de fases de vida alrededor de una carta natal. El renderer bi-wheel superpone una carta sobre otra (p. ej. tránsito sobre natal) con ambos anillos visibles. Comparten el mismo core de Kerykeion vendorizado que el endpoint chart_svg estándar, así que los presets de tema y params de parche aplican.

¿Cómo integro esto con mi app?

Es una API REST. Envía datos de nacimiento (fecha, hora, ubicación), más tema y cualquier param de personalización, recibes un string SVG de vuelta. Funciona con cualquier lenguaje — curl, JavaScript, Python, Ruby, PHP, Go. Para web, mete el SVG directamente en la página. Para apps móviles, pide PNG o WebP a través de los endpoints de conversión de formato. Misma auth, mismos rate limits, mismo modelo de créditos en todos los tipos de carta.

¿Hay rate limiting en la generación de cartas?

Los rate limits dependen del plan. Ultra (55.000 créditos/mes) cubre la mayoría de plataformas independientes. Business (220.000 créditos) encaja con apps en crecimiento. Los planes Enterprise corren en infraestructura dedicada sin tope mensual. A 10 créditos por carta, Ultra te da ~5.500 cartas/mes y Business te da ~22.000 — el límite es el pool de créditos, no un rate limit por segundo.

Cartas SVG Personalizables

API de Renderizado de Cartas: SVG Nivel Astrocom, Tus Reglas

Vendorizamos Kerykeion v4.26.3 para poder parchearlo.

Resultado: 3 presets de tema, un preset estilo Astrocom, 10+ parámetros de carta, Parte de la Fortuna, planetas uranianos, y natal/sinastría/tránsitos/compuesta desde un solo endpoint.

Ver Demo

Gantt

Barras de Timing de Tránsitos

22,5°

Ebertin 4ª Armónica

Astrocom

Presets de Tema

10+

Params Custom

2,1M+ cartas renderizadas al mes

Usado por 750+ plataformas en todo el mundo

Precisión Swiss Ephemeris garantizada

Los dashboards de pronóstico necesitan vistas de timing pro — barras Gantt y efemérides gráficas — no solo ruedas natales
El output estándar de Kerykeion es fijo: mismos ejes, mismas fuentes, mismo look en cada sitio
No hay forma de imitar la estética Astrocom (Astrodienst) que esperan los astrólogos tradicionales
Las líneas de aspectos se amontonan — y no puedes ocultar puntos específicos sin sacarlos de la rueda
La Parte de la Fortuna no existe en el renderizado upstream (sin glifo, sin fila de aspectos)
Los ejes (AC, MC, DC, IC) renderizan todos igual — no puedes engrosarlos ni cambiar la posición de las etiquetas
La Escuela de Hamburgo y los astrólogos uranianos no pueden mostrar sus planetas hipotéticos
Los números de casas atascados en un sitio; sin opción de anillo interior
Los flujos de Cosmobiology necesitan la rejilla Ebertin 4ª armónica; la mayoría de APIs no la traen

Transforma con

/api/v3/render/* es el namespace consolidado — ruedas de carta, Gantt de tránsitos, efemérides gráficas todos viven como hermanos
/render/transit-gantt: visualización de barras horizontales de ventanas de timing de aspectos para dashboards de pronóstico
/render/graphic-ephemeris: rejilla 4ª armónica 22,5° estilo Ebertin trazando planetas como líneas continuas
Capas SVG con nombre (g id='axes', g id='aspects', g id='planets') para estilado CSS downstream
3 presets de tema: minimal, minimal-dark, astrocom-dark — eliges look con un parámetro
Preset Astrocom: ejes más gruesos, etiquetas AC/MC/DC/IC fuera del anillo, números de casas centrados — de fábrica
10+ params de carta: axis_stroke_width, axes_labels_position, house_numbers_position, axis_color, y más
hide_points_in_aspects: quita planetas seleccionados de las líneas de aspectos manteniéndolos en la rueda
Parte de la Fortuna + 8 hipotéticos uranianos renderizan en el servidor
Natal, sinastría, tránsitos, compuesta — mismo endpoint de carta, mismo sistema de temas

Rendimiento del Renderizado de Cartas

Kerykeion v4.26.3 vendorizado con nuestra capa de personalización

Presets de Tema

10+

Params de Personalización

SVG (post-procesado)

Output Principal

<500ms

Tiempo de Render

Rueda, Gantt de Tránsitos, Efemérides Gráficas

Endpoints de Render

2,1M+

Renderizados Mensuales

SVG Personalizable, Desde el Tema Hasta un Solo Eje

3 presets, 10+ params, output nivel Astrocom

Transit Gantt SVG

/render/transit-gantt dibuja barras horizontales para ventanas de timing de aspectos. Las filas son pares de planetas, las columnas son fechas, ticks de hit exacto dentro de cada barra.

Endpoint: /api/v3/render/transit-gantt — coloreado por tipo de aspecto, capas SVG con nombre

Efemérides Gráficas SVG

/render/graphic-ephemeris traza planetas como líneas continuas sobre la rejilla Ebertin 4ª armónica 22,5°. Los encuentros de líneas marcan aspectos duros por lógica de Cosmobiology.

Endpoint: /api/v3/render/graphic-ephemeris — armónica 1/2/4/8/16, ventana default de 12 meses

Estándar Ebertin 4ª Armónica

La rejilla 22,5° es el estándar de facto de Cosmobiology desde los años 40. La traemos como armónica default en graphic-ephemeris.

harmonic=4 default; conmutable a 1, 2, 8, 16 por request

Capas SVG con Nombre

Cada output de render agrupa elementos en capas SVG con nombre (g id='axes', 'aspects', 'planets', 'bars', 'ticks') para que el CSS downstream pueda re-estilar sin parsear geometría.

Convención de nombrado de id estable en todos los endpoints /render/*

Namespace /render/*

Un namespace para visualizaciones: ruedas de carta, Gantt de tránsitos, efemérides gráficas. Los paths viejos /svg/timing/* siguen funcionando por compatibilidad hacia atrás.

Consolidado bajo /api/v3/render/* — /svg/timing/* legacy aliased

Preset de Tema Astrocom

Un parámetro (theme=astrocom) te da el look de carta de astro.com — ejes gruesos, etiquetas AC/MC/DC/IC fuera del anillo, números de casas centrados, color de eje unificado.

Combina PATCH-01, PATCH-02, PATCH-03, PATCH-04 con color de eje #444444

Tema Astrocom-Dark

Contraparte oscura de Astrocom — mismos parches estructurales, papel oscuro, color de eje unificado afinado para UIs oscuras.

axis_color=#6b7280, se monta sobre dark.css de Kerykeion

Tema Minimal

Tema claro y limpio con líneas de aspectos suaves y sectores de zodíaco planos — para embeds que no deben pelear con la página.

Se monta sobre classic.css, sin parches estructurales aplicados

Tema Minimal-Dark

Mismo look minimal sobre papel oscuro — funciona para UI oscura sin escribir CSS extra.

Hereda colores de papel y sectores de zodíaco de dark.css

Parámetro axis_stroke_width

Controla cuán gruesos renderizan los ejes AC/MC/DC/IC. 1.0 default, 3.0 imita a astro.com, 5.0 para pósters.

Float — aplica solo a cúspides de eje (índices 0, 3, 6, 9), línea sólida a opacidad 0.9

Parámetro axes_labels_position

Coloca las etiquetas AC/MC/DC/IC fuera de la rueda (bold), en un anillo interior pequeño (peso medio), o las oculta del todo.

Acepta 'outside' | 'center' | null — la matemática de coordenadas reusa la fórmula de offset de cúspide

Parámetro house_numbers_position

Renderiza los números de casas en un anillo interior al 78% de radio (estilo astro.com) o junto a cada cúspide (default).

Acepta 'center' | 'near_cusp' — también aplica al sujeto secundario en sinastría/tránsitos

Glifo de Parte de la Fortuna

Añade 'part_of_fortune' a active_points — el glifo de cruz dentro de círculo renderiza en la rueda y aparece una fila de Parte de la Fortuna en la cuadrícula de aspectos.

Fórmula día/noche, id=23 para mantener estables los accesos indexados upstream

hide_points_in_aspects

Pasa un array de nombres de puntos para quitarlos de las líneas de aspectos y de la cuadrícula — sin sacar los glifos de la rueda.

Post-procesador sobre el string SVG — corre después de makeTemplate() de Kerykeion

hide_axes_visually

Mantén AC/MC/DC/IC en el cálculo pero oculta las líneas del SVG. Útil para vistas de embed limpias.

Post-procesador a nivel stub — acepta array de nombres de eje

Planetas Hipotéticos

8 hipotéticos uranianos / Escuela de Hamburgo — Cupido, Hades, Zeus, Kronos, Apollon, Admetos, Vulcanus, Poseidón — renderizan con sus propios glifos.

Añádelos a active_points; settings_builder inyecta glifo + config de color

Cabecera de Doble Carta

Las cartas de sinastría y tránsitos mantienen su cabecera de doble sujeto tras el refactor del renderer — ambos nombres y fechas de nacimiento renderizan sobre la rueda.

Preservado a través del facade ChartRenderer en app/services/chart_renderer/renderer.py

Tipo de Carta Compuesta

Las cartas compuestas por puntos medios renderizan a través del mismo endpoint con el mismo sistema de temas.

chart_type='Composite' en el facade unificado de ChartRenderer

Precisión Swiss Ephemeris

Los datos de efemérides NASA JPL alimentan cada posición planetaria sin importar el tema o el tipo de carta.

Precisión sub-arcosegundo para todos los cuerpos celestes

23 Sistemas de Casas

Placidus, Whole Sign, Equal House, Koch, Regiomontanus, Campanus, Morinus, Porphyry, Topocéntrico, y 14 más.

Selección de sistema de casas independiente del tema

Override de Custom Settings

Pasa un dict custom_settings para sobreescribir cualquier campo de carta por request — colores, colores de glifo, colores de papel, colores de zodíaco.

Se mergea sobre los defaults del tema; gana quien llama

¿Qué es la API de Renderizado de Cartas? La Historia del Kerykeion Vendorizado

3 presets de tema, 10+ params de personalización, output nivel Astrocom, Parte de la Fortuna, planetas uranianos

La API de Renderizado de Cartas convierte datos de nacimiento en una carta astrológica SVG personalizable. Vendorizamos Kerykeion v4.26.3 dentro de nuestro propio código para poder parchearlo — eso nos dio ejes más gruesos, etiquetas fuera del anillo, números de casas centrados, un glifo de Parte de la Fortuna, soporte para planetas hipotéticos, y un post-procesador que puede ocultar puntos seleccionados de las líneas de aspectos. Tienes tres presets de tema de fábrica (minimal, minimal-dark, astrocom-dark), 10+ parámetros de carta, y un solo endpoint que maneja cartas natales, de sinastría, de tránsitos y compuestas. El tiempo de render se mantiene por debajo de 500ms.

¿Por qué vendorizamos Kerykeion v4.26.3 en vez de importarlo?

Kerykeion es una buena librería open-source de cartas, pero el renderer upstream está cerrado: anchos de eje fijos, sin Parte de la Fortuna, sin hooks para ocultar puntos de las líneas de aspectos, y sin camino para planetas hipotéticos de la Escuela de Hamburgo.

Copiamos los módulos relevantes a app/vendor/kerykeion_charts/ en la versión 4.26.3, mantuvimos la superficie de imports compatible, y añadimos un PATCHES.md que rastrea cada cambio.

Cuatro parches numerados (PATCH-01 a PATCH-04) más una inyección de Parte de la Fortuna cubren los nuevos parámetros.

Dos temas que vienen con la librería upstream (light, dark, dark-high-contrast, classic) siguen funcionando como capas base.

Nuestros presets se superponen encima de esas variables CSS base, así que los colores de papel en modo oscuro, los colores de sector del zodíaco y los colores de glifos heredan limpiamente.

El enfoque vendor significa que cada upgrade upstream es una revisión de código — no un breaking change sorpresa en producción.

Kerykeion v4.26.3 vendorizado — nosotros controlamos la línea de parches

1 min read

¿Qué tema elijo: minimal, minimal-dark o astrocom-dark?

Tres presets cubren la mayoría de casos.

Minimal es un tema claro y limpio: líneas de aspectos suaves, sectores de zodíaco planos, papel claro.

Úsalo para embeds de blog, social cards, y apps que quieren una carta que no pelee con el resto de la página.

Minimal-dark invierte el papel a gris oscuro, mantiene los colores de aspectos legibles, y funciona para UIs oscuras.

Astrocom-dark es la contraparte oscura del preset Astrocom: ejes más gruesos, etiquetas AC/MC/DC/IC fuera del anillo, números de casas centrados, color de eje unificado (#6b7280) — básicamente el look de carta de Astrodienst en un wrapper oscuro.

Pasa theme=astrocom para la versión clara, theme=astrocom-dark para oscura, theme=minimal para un look claro limpio, o theme=minimal-dark para lo mismo en oscuro.

Puedes seguir sobreescribiendo cualquiera de los parámetros subyacentes por request, así que un tema es un punto de partida — no una jaula.

3 presets: minimal, minimal-dark, astrocom-dark — más astrocom (claro)

1 min read

¿Qué es el preset Astrocom y por qué importa?

Astrocom es el look que ves en astro.com — la carta de Astrodienst que los astrólogos profesionales llevan leyendo desde los 90.

Es el estilo de referencia de facto para la tradición occidental: líneas de eje negras gruesas, etiquetas AC/MC/DC/IC justo fuera de la rueda, números de casas en un anillo interior en vez de junto a las cúspides, y un único color neutro de eje para que las cuatro direcciones cardinales no peleen entre sí.

El preset astrocom combina PATCH-01 (axis_stroke_width=3.0), PATCH-02 (axes_labels_position='outside'), PATCH-03 (house_numbers_position='center') y PATCH-04 (axis_color='#444444' para claro, '#6b7280' para oscuro).

Pones theme=astrocom y obtienes los cuatro a la vez.

Para plataformas dirigidas a astrólogos tradicionales, este preset por sí solo suele ser la razón por la que los equipos cambian.

El tema classic de Kerykeion tiene colores por eje (naranja/negro/azul/rojo) que chocan con un layout más sobrio — astrocom los unifica.

Preset Astrocom = look de referencia de astro.com en un parámetro

1 min read

¿Cómo funcionan los parámetros por elemento?

Cinco parámetros te dejan sobreescribir el preset en un solo request.

axis_stroke_width toma un float — 1.0 es default, 3.0 imita a astro.com, 5.0 es grosor de póster.

axes_labels_position acepta 'outside' (justo fuera de la rueda, bold), 'center' (anillo interior pequeño, peso medio), o null (sin etiquetas de eje — comportamiento de Kerykeion pre-parche).

house_numbers_position toma 'center' (anillo interior pequeño al 78% de radio, fuente 10px, opacidad 0.7) o 'near_cusp' (default, 14px, junto a cada cúspide).

hide_points_in_aspects toma un array de nombres: pasa ['Chiron','Lilith'] y Quirón y Lilith se quedan en la rueda pero desaparecen de cada línea de aspecto y de la fila en la cuadrícula.

hide_axes_visually toma un array de nombres de ejes: el AC se queda en el cálculo, pero no se dibuja línea — útil para embeds donde quieres una rueda limpia.

axis_color sobreescribe las variables CSS por eje con un único color unificado.

5 params de parche: axis_stroke_width, axes_labels_position, house_numbers_position, hide_points_in_aspects, hide_axes_visually

1 min read

¿Qué es el endpoint /render/transit-gantt?

/api/v3/render/transit-gantt es un renderer SVG para ventanas de timing de aspectos.

En vez de una rueda, obtienes una carta de barras horizontales: las filas son pares de planetas (p.

ej.

Saturno en tránsito a Sol natal), las columnas son fechas, y cada barra marca la ventana en la que el aspecto está en orbe.

Las fechas de hit exacto aparecen como ticks verticales dentro de cada barra.

El output es una vista de dashboard de pronóstico que astrólogos y apps de timing necesitan — cuándo empieza este tránsito, cuándo pica, cuándo termina.

Las barras están coloreadas por tipo de aspecto (conjunción, cuadratura, oposición, trígono, sextil) y el SVG viene con capas con nombre (g id='bars', g id='ticks', g id='axis') para que el CSS downstream pueda re-estilar sin parsear geometría.

La spec vive en docs/SPECS/06_timing_visualizations.md §A, renderer en app/services/render/transit_gantt.py.

Rango de tiempo, aspectos incluidos y tolerancias de orbe son parámetros del request.

/render/transit-gantt — SVG de barras horizontales para ventanas de timing de aspectos

1 min read

¿Qué es el endpoint /render/graphic-ephemeris?

/api/v3/render/graphic-ephemeris son las efemérides gráficas 4ª armónica estilo Ebertin — un clásico de Cosmobiology desde los años 40.

El eje X es tiempo.

El eje Y es la rejilla 22,5° (360° / 16 — la 4ª armónica, o cuarta división del dial básico de 22,5°).

Cada planeta se traza como una línea continua que envuelve cuando cruza 22,5°.

Cuando dos líneas se encuentran en la rejilla, eso es un aspecto duro por lógica de 4ª armónica: conjunción, oposición, cuadratura o semicuadratura.

Los practicantes de Cosmobiology leen esos encuentros como fechas de eventos.

Opciones de armónica: 1 (longitud cruda), 2, 4 (default de Ebertin), 8, o 16.

La ventana de tiempo default es 12 meses, configurable.

El output es SVG con capas con nombre (g id='planet-sun', g id='planet-moon', etc.) para que cada línea planetaria sea seleccionable por CSS.

Spec: docs/SPECS/06_timing_visualizations.md §B.

Renderer: app/services/render/graphic_ephemeris.py.

/render/graphic-ephemeris — rejilla Ebertin 4ª armónica 22,5°

1 min read

Use Cases

Plataformas de Astrólogos Tradicionales

theme=astrocom da el look de astro.com en el que los profesionales ya confían

Apps Modernas en Modo Oscuro

theme=minimal-dark o astrocom-dark casan con UI oscura sin trabajo extra de CSS

Cartas Helenísticas con Parte de la Fortuna

Añade 'part_of_fortune' a active_points — glifo y fila de aspectos renderizan automáticamente

Uraniana / Escuela de Hamburgo

8 planetas hipotéticos (de Cupido a Poseidón) renderizan con sus propios glifos

Embeds Centrados en Aspectos

hide_points_in_aspects quita cuerpos menores de las líneas manteniendo la rueda intacta

Sinastría, Tránsitos, Compuesta

Un endpoint, mismo sistema de temas, cabecera de doble carta preservada entre tipos

Technical Specifications

Namespace de Render	/api/v3/render/* (chart, transit-gantt, graphic-ephemeris)
Rango de Tiempo del Gantt de Tránsitos	Default 12 meses; start/end configurable
Armónica de Efemérides Gráficas	1, 2, 4 (default Ebertin), 8, o 16
Nombrado de Capas SVG	g id='axes' \| 'aspects' \| 'planets' \| 'bars' \| 'ticks'
Base del Renderer	Kerykeion v4.26.3 vendorizado + 4 parches numerados
Presets de Tema	minimal, minimal-dark, astrocom, astrocom-dark
Temas Nativos de Kerykeion	light, dark, dark-high-contrast, classic
axis_stroke_width	Float — 1.0 default, 3.0 astrocom, hasta 5.0
axes_labels_position	outside \| center \| null (sin etiquetas)
house_numbers_position	center (anillo interior a r*0.78) \| near_cusp (default)
axis_color	String hex — sobreescribe variables CSS por eje
hide_points_in_aspects	Array de nombres — el post-procesador los quita de las líneas de aspectos
hide_axes_visually	Array de nombres de ejes — se quedan en cálculo, fuera del SVG
active_points	Incluye part_of_fortune + 8 hipotéticos uranianos
Tipos de Carta	Natal, Sinastría, Tránsitos, Compuesta (un endpoint)
Formatos de Salida	SVG principal; PNG, JPEG, WebP, PDF vía conversión
Tiempo de Render	<500ms típico, <1s peor caso
Sistemas de Casas	23 soportados (Placidus, Whole Sign, Koch, etc.)
Precisión de Cálculo	Swiss Ephemeris (datos NASA JPL)
Override de Custom Settings	Dict custom_settings — cualquier campo, por request

Kerykeion Vendorizado + Parches vs Kerykeion Estándar vs Competidores Cerrados

Feature	Astrology API	Others
Cobertura de Visualización	Rueda + Gantt de tránsitos + efemérides gráficas (3 endpoints de render)	Solo ruedas natales
Base del Código	Kerykeion v4.26.3 vendorizado — controlamos los parches	pip install estándar O SDK cerrado
Output Estilo Astrocom	theme=astrocom — un parámetro	No disponible; estilo de carta cerrado
Presets de Tema	minimal, minimal-dark, astrocom, astrocom-dark	Look fijo o 1-2 temas
Grosor de Eje	Param float, 1.0 a 5.0+	Hardcodeado a 1px
Posición de Números de Casas	center \| near_cusp	Solo junto a la cúspide
Ocultar Puntos de Aspectos	Array hide_points_in_aspects — post-procesador	Todo o nada; los quita de la carta entera
Parte de la Fortuna	Fórmula + glifo + fila en cuadrícula de aspectos	No soportado (Kerykeion); varía en otros
Planetas Hipotéticos	8 uranianos (de Cupido a Poseidón) nativos	Rara vez soportados
Tipos de Carta	Natal, Sinastría, Tránsitos, Compuesta — un endpoint	Endpoints o librerías separados
Camino de Upgrade Upstream	Code review en cada bump — PATCHES.md trackeado	Breaking changes silenciosos al hacer pip upgrade
Tiempo de Render	<500ms típico	1-3 segundos común

APIs de Astrología Relacionadas

Transit Gantt SVG

Visualización de barras horizontales de ventanas de timing de aspectos

Efemérides Gráficas SVG

Rejilla 4ª armónica 22,5° estilo Ebertin

API Natal

Cálculos de carta natal que alimentan el renderer

Parte de la Fortuna

Lote helenístico — fórmula, glifo, fila de aspectos

Planetas Hipotéticos

Escuela de Hamburgo / Uranianos — 8 hipotéticos nativos

API de Sinastría

Cartas de relación con el mismo sistema de temas

API de Compuesta

Cartas compuestas por puntos medios para parejas

API de Timing

SVGs de timing con age-bands y bi-wheel

API de Tránsitos

Tránsitos en vivo sobre una rueda natal

References & Standards

Swiss Ephemeris (DE431-based) — astronomical calculations source
NASA JPL Planetary Ephemerides — underlying ephemeris dataset
International Astronomical Union (IAU) — body designation and nomenclature standards
IANA Time Zone Database — timezone & DST resolution

Precios Simples y Transparentes

Comienza gratis, escala a medida que creces. Sin cargos ocultos.

Siempre Gratis

Sin Tarjeta de Credito

Perfecto para aprender, probar y proyectos personales pequenos

50 llamadas API/mes

Cartas natales basicas

5 sistemas de casas

Soporte comunitario

Pro

$11/mes

Para apps pequenas y proyectos personales

Todos los endpoints basicos
12 sistemas de casas
Soporte por email

Mejor Valor

Pro Plus

$21/mes

Para apps en crecimiento y trafico medio

Todos los endpoints mejorados
18 sistemas de casas
Interpretaciones con IA
Soporte email prioritario

Ultra

$37/mes

Para aplicaciones de astrologia profesionales

Credit math ↓

Todos los endpoints premium
23 sistemas de casas
Interpretaciones IA avanzadas
Soporte prioritario

Planes de Alto Volumen

Para aplicaciones a escala empresarial

Business

$99/mes

Para aplicaciones de alto volumen

Credit math ↓

TODOS los endpoints
Listo para marca blanca
Ajuste fino de IA personalizado
Soporte telefonico

ILIMITADO

Enterprise

$399+por mes

Peticiones ilimitadas con infraestructura dedicada

Infraestructura de servidor dedicado
Sub-300ms garantizado
Soporte dedicado 24/7
99.99% uptime SLA

Todos los planes incluyen documentacion completa y SDKs

Preguntas? Habla con nuestro equipo

Preguntas Frecuentes sobre la API de Renderizado de Cartas

Temas, parches, Parte de la Fortuna, planetas hipotéticos, y todo lo de en medio

APIs de Astrología Relacionadas

La API Chart SVG funciona mejor junto al resto del stack. Añade

Gantt de tránsitos SVG efemérides gráficas SVG cálculos de carta natal Parte de la Fortuna planetas hipotéticos cartas de sinastría cartas compuestas ruedas de timing tránsitos en vivo

Tres Renderers SVG, Un Namespace

Ruedas de carta, barras Gantt de tránsitos, y efemérides gráficas sobre la rejilla Ebertin 4ª armónica 22,5° — todo bajo /api/v3/render/*. Temas Astrocom, capas SVG con nombre, Parte de la Fortuna, planetas uranianos.

Empezar Gratis Ver Documentación

Gantt de tránsitos + efemérides gráficas SVG

Rejilla Ebertin 4ª armónica 22,5°

Capas SVG con nombre para estilado CSS

<500ms de tiempo de render

Disponible en plan Ultra y superiores

API de Renderizado de Cartas: SVG Nivel Astrocom, Tus Reglas

Las Ruedas Natales Solas No Mueven Dashboards de Pronóstico

Un Namespace de Render: Ruedas, Barras Gantt, Efemérides Gráficas

Rendimiento del Renderizado de Cartas

SVG Personalizable, Desde el Tema Hasta un Solo Eje

Transit Gantt SVG

Efemérides Gráficas SVG

Estándar Ebertin 4ª Armónica

Capas SVG con Nombre

Namespace /render/*

Preset de Tema Astrocom

Tema Astrocom-Dark

Tema Minimal

Tema Minimal-Dark

Parámetro axis_stroke_width

Parámetro axes_labels_position

Parámetro house_numbers_position

Glifo de Parte de la Fortuna

hide_points_in_aspects

hide_axes_visually

Planetas Hipotéticos

Cabecera de Doble Carta

Tipo de Carta Compuesta

Precisión Swiss Ephemeris

23 Sistemas de Casas

Override de Custom Settings

¿Qué es la API de Renderizado de Cartas? La Historia del Kerykeion Vendorizado

¿Por qué vendorizamos Kerykeion v4.26.3 en vez de importarlo?

¿Qué tema elijo: minimal, minimal-dark o astrocom-dark?

¿Qué es el preset Astrocom y por qué importa?

¿Cómo funcionan los parámetros por elemento?

¿Qué es el endpoint /render/transit-gantt?

¿Qué es el endpoint /render/graphic-ephemeris?

Use Cases

Plataformas de Astrólogos Tradicionales

Apps Modernas en Modo Oscuro

Cartas Helenísticas con Parte de la Fortuna

Uraniana / Escuela de Hamburgo

Embeds Centrados en Aspectos

Sinastría, Tránsitos, Compuesta

Technical Specifications

Kerykeion Vendorizado + Parches vs Kerykeion Estándar vs Competidores Cerrados

APIs de Astrología Relacionadas

Transit Gantt SVG

Efemérides Gráficas SVG

API Natal

Parte de la Fortuna

Planetas Hipotéticos

API de Sinastría

API de Compuesta

API de Timing

API de Tránsitos

References & Standards

Precios Simples y Transparentes

Siempre Gratis

Pro

Pro Plus

Ultra

Planes de Alto Volumen

Business

Enterprise

Preguntas Frecuentes sobre la API de Renderizado de Cartas

¿Qué es el endpoint /render/transit-gantt?

¿Qué es el endpoint /render/graphic-ephemeris?

¿Qué es la Cosmobiology de Ebertin?

¿Por qué la 4ª armónica 22,5° es el estándar?

¿Las capas SVG tienen nombre para estilado downstream?

¿Qué temas de carta están disponibles?

¿Puedo conseguir una carta estilo Astrocom?

¿Cómo personalizo el grosor de los ejes?

¿Puedo ocultar planetas específicos de las líneas de aspectos?

¿La API renderiza la Parte de la Fortuna?

¿Soportan planetas uranianos / Escuela de Hamburgo?

¿Puedo renderizar cartas de sinastría, tránsitos y compuestas?

¿Por qué vendorizaron Kerykeion v4.26.3 en vez de solo importarlo?

¿Dónde van los números de casas con house_numbers_position='center'?

¿Qué hace hide_axes_visually?

¿Cuánto tarda el render?

¿Qué formatos de salida obtengo?

¿Puedo sobreescribir settings de tema por request?