kerykeion

Kerykeion est une bibliothèque Python dédiée aux calculs astrologiques et au rendu de thèmes SVG. Elle calcule les positions planétaires, les maisons, les aspects, les retours, les progressions et les techniques associées, puis expose les résultats sous forme de modèles Pydantic qui peuvent être inspectés en Python, exportés en JSON ou sérialisés en XML pour le contexte d'un LLM. Les paramètres par défaut utilisent le zodiaque tropical, les maisons Placidus et les positions géocentriques apparentes. La bibliothèque sépare le calcul de la présentation : AstrologicalSubjectFactory calcule le ciel, les maisons, les points et la provenance ; ChartDataFactory ajoute les aspects, les distributions, les angularités, les stelliums, les scores relationnels et les comparaisons de maisons ; ChartDrawer restitue en SVG des données déjà calculées. ReportGenerator produit du texte, to_context produit du XML et model_dump_json produit du JSON. Les types de thèmes pris en charge incluent les thèmes natals et événementiels, la synastrie, les transits, les retours solaires et lunaires, les retours héliocentriques, les croisements de nœuds lunaires, les thèmes composites par points médians et les thèmes de Davison, les thèmes relocalisés, les progressions secondaires et les directions par arc solaire. La configuration couvre les zodiaques tropical ou sidéral (47 modes nommés plus un ayanamsa USER personnalisé), les systèmes de maisons, les solutions de repli pour les maisons polaires, les perspectives géocentrique apparente/vraie, topocentrique, héliocentrique, barycentrique et planétocentrique, ainsi qu'un ensemble de points actifs configurable incluant les nœuds, les variantes de Lilith, les Parties arabes, les astéroïdes, les centaures, les objets transneptuniens, les points uraniens et des étoiles fixes optionnelles. Les fonctionnalités d'analyse incluent les aspects sur un ou deux thèmes, les aspects de déclinaison, le mouvement appliqué/séparant, les orbes personnalisés, la comparaison de maisons, un score relationnel de Ciro Discepolo, les distributions par élément et par qualité, les angularités, les stelliums et les dignités essentielles. Les thèmes existent en styles Modern et Classic, avec des thèmes classic, dark et noir et blanc. L'installation nécessite Python 3.12 ou une version plus récente via pip. Le niveau d'éphéméride révisé par défaut utilise JPL DE440s couvrant 1850–2150, avec des niveaux plus larges disponibles via libephemeris. Les calculs hors ligne nécessitent une longitude, une latitude et un fuseau horaire IANA ; le mode en ligne peut résoudre les lieux via GeoNames. Une interface en ligne de commande et une compétence d'agent IA sont également fournies. Le projet est sous licence AGPL-3.0, avec une API hébergée proposée pour un usage commercial à code fermé.