Astrolinkers — astrology API programable

El problema

El software de astrología suele dividirse en dos formas débiles: apps de horóscopos de consumo con interpretaciones superficiales, o herramientas de cálculo antiguas que cuesta integrar en productos modernos. Astrolinkers está construido para el centro que falta: una astrology API programable que otros builders puedan usar dentro de productos, flujos de trabajo, herramientas internas y experimentos.

La promesa del producto es deliberadamente técnica: una sola REST API para natal charts, talent profiles, compatibilidad por pares, interpretaciones por plantilla, reescrituras opcionales con AI, reportes PDF asíncronos y un amplio motor de cálculo Vedic. El sitio público lo posiciona como «natal charts, talent profiles & compatibility programáticos — para builders», con un tier gratuito para makers, dashboard, live demo y SDKs oficiales en Python y TypeScript.

Qué hace el producto

Astrolinkers convierte datos de hora de nacimiento en salidas astrológicas estructuradas. La API principal crea natal charts Western o Vedic, deriva talent profiles a partir de una ontología de habilidades, genera interpretaciones basadas en plantillas, calcula compatibilidad por pares, recopila feedback por afirmación y produce reportes HTML/PDF a través de un pipeline asíncrono de workers.

El lado Vedic es intencionadamente profundo en lugar de decorativo: divisional charts, bhava chakra, Parashara drishti, dignidad, naturaleza funcional, Vimshottari dasha, yogas, Ashtakavarga, Shadbala, Panchanga, karakas Jaimini, arudha, progresiones, tránsitos, Varshaphala, sub-lords KP y optimización de muhurta se exponen a través de endpoints documentados.

El sistema está en beta, pero no en el sentido de «maqueta». Tiene un sitio de marketing público, documentación pública de la API, puntos de entrada al dashboard, un endpoint de live demo, API keys autoservicio, rate limits, SDKs tipados y controles operativos orientados a producción.

Un vistazo al producto

• 

  El sitio público, dirigido a builders: una REST API para cartas occidentales y védicas, perfiles de talento y compatibilidad — con un tier gratuito para makers y una demo que puedes probar sin registrarte.

• 

  La documentación pública de la API. La carta natal es el artefacto fundacional que todos los demás endpoints referencian por id; este es su contrato POST /v1/charts, con el árbol completo de endpoints occidentales y védicos en la barra lateral.

• 

  Inicio de sesión self-serve en el panel, donde los usuarios gestionan sus claves de API y su uso — incluida una vía con token emitido por el operador para cuentas provisionadas fuera del flujo normal.

• 

  Analítica de uso por clave: volumen de peticiones, errores, tasa de éxito y un gráfico de peticiones por hora sobre una ventana móvil. La observabilidad de la plataforma, devuelta al usuario.

• 

  Planes self-serve. El tier gratuito para makers está activo con límites y cuotas reales; los de pago muestran sus límites mientras se termina la facturación — los límites están cableados antes que el muro de pago.

Qué construí

La plataforma de backend. Construí la API como un servicio Python de arquitectura limpia: FastAPI en el borde, los use-cases de aplicación en el medio, tipos de dominio y protocolos en el núcleo, y adaptadores concretos para Postgres, Redis, la cola de tareas Dramatiq, object storage, email, proveedores de LLM (Anthropic, OpenAI y Ollama self-hosted) y Swiss Ephemeris.

Capa de cálculo astrológico. El núcleo usa Swiss Ephemeris a través de un adaptador dedicado y envuelve tanto los cálculos Western como los Vedic detrás de fronteras de servicio estables. El contrato público es JSON in / JSON out; internamente, el objetivo es la reproducibilidad, la testabilidad y una vía para extraer el motor de cálculo más adelante si llega a ser un cuello de botella de rendimiento.

Pipeline de talent profiles e interpretaciones. Una ontología de habilidades mapea las señales derivadas del chart en puntuaciones de soft y hard skills. Las afirmaciones basadas en plantillas dan una salida determinista, mientras que la capa de LLM puede reescribir las interpretaciones por tono sin convertir al LLM en la fuente de verdad.

Reportes asíncronos. La generación pesada de reportes no se maneja como una petición HTTP larga. Un reporte se encola, lo procesan los workers, se renderiza a HTML/PDF, se guarda en object storage y se devuelve mediante un flujo de descarga firmado.

Controles de producción. La plataforma incluye auth JWT/bearer, emisión y revocación de API keys, aislamiento por tenant, comprobaciones de scope deny-by-default, idempotencia para las peticiones que mutan estado, rate limiting, seguimiento de cuotas y uso, middleware de auditoría, errores estructurados, readiness probes, métricas, tracing e integración con Sentry.

SDKs y experiencia de desarrollador. También publiqué docs públicas y SDKs oficiales: Python (astrolinkers-sdk) y TypeScript (@astrolinkers/sdk-ts). Los SDKs exponen métodos tipados, validación de respuestas, comportamiento de reintentos y errores tipados para que los usuarios no tengan que armar a mano las llamadas HTTP.

Decisiones arquitectónicas

Monolito modular primero. El sistema es una sola base de código con varios procesos: API, worker y scheduler. Eso mantiene la entrega rápida a la vez que preserva costuras claras alrededor de astrología, reportes, interpretaciones, feedback, auth, uso y API keys. Si un dominio necesita separarse más adelante, los ports ya existen.

El LLM como adaptador, no como la arquitectura. Astrolinkers tiene interpretaciones con AI, pero la plataforma no depende de un único modelo. Los proveedores de LLM están detrás de protocolos y de una política de routing, con fallbacks, seguimiento de costes, seguimiento de latencia y la salida determinista por plantilla como línea base.

El feedback como foso defensivo. Cada afirmación de interpretación puede recopilar feedback de precisión. Eso convierte la calidad subjetiva de la interpretación en datos: la precisión de las plantillas puede agregarse, las reglas débiles pueden detectarse y el scoring futuro puede mejorarse a partir del juicio real de los usuarios en lugar de conjeturas.

Observable desde el primer día. El sistema expone métricas Prometheus, trazas OpenTelemetry, logs estructurados, /healthz, /readyz, /version y SLOs operativos. Esto es importante porque el cálculo astrológico, los proveedores de LLM, las colas de workers y el renderizado de PDF fallan de maneras distintas.

Beta con disciplina de producción. Astrolinkers está actualmente en beta, pero se trata como un servicio de producción real: API versionada, envelope de errores documentado, rate limits, fronteras por tenant, runbooks, SLOs, manifiestos de despliegue y soft-launch gates.

Estado actual

Astrolinkers está en vivo en astrolinkers.com, con documentación pública en docs.astrolinkers.com. El dashboard vive en app.astrolinkers.com, y el sitio público incluye un live demo de charts contra el mismo motor de cálculo que los usuarios usan a través de la API.

Construí el proyecto en solitario: planteamiento de producto, arquitectura de backend, integración del motor de astrología, contrato de la API, auth y cuotas, pipeline de reportes, docs, SDKs, postura de despliegue y endurecimiento operativo. La siguiente etapa es ampliar el uso en beta, ajustar los bucles de feedback y convertir los datos de uso real en mejor calidad de interpretación y un packaging comercial más claro.