kerykeion

Kerykeion é uma biblioteca Python para cálculos astrológicos e renderização de mapas SVG. Ela calcula posições planetárias, casas, aspectos, retornos, progressões e técnicas relacionadas, e então expõe os resultados como modelos Pydantic que podem ser inspecionados em Python, exportados como JSON ou serializados como XML para contexto de LLM. Os padrões usam o zodíaco tropical, casas Placidus e posições geocêntricas aparentes. A biblioteca separa cálculo de apresentação: AstrologicalSubjectFactory calcula o céu, casas, pontos e proveniência; ChartDataFactory adiciona aspectos, distribuições, angularidades, stelliums, pontuações de relacionamento e comparações de casas; ChartDrawer renderiza dados já calculados em SVG. ReportGenerator produz texto, to_context produz XML e model_dump_json produz JSON. Os tipos de mapa suportados incluem mapas natais e de eventos, sinastria, trânsitos, retornos solar e lunar, retornos heliocêntricos, cruzamentos de nodos lunares, composto por pontos médios e mapas de Davison, mapas realocados, progressões secundárias e direções de arco solar. A configuração abrange zodíacos tropical ou sideral (47 modos nomeados mais um ayanamsa USER personalizado), sistemas de casas, fallbacks de casas polares, perspectivas geocêntrica aparente/verdadeira, topocêntrica, heliocêntrica, baricêntrica e planetocêntrica, e um conjunto configurável de pontos ativos incluindo nodos, variantes de Lilith, Partes Árabes, asteroides, centauros, objetos transnetunianos, pontos uranianos e estrelas fixas opcionais. Os recursos de análise incluem aspectos de mapa único e duplo, aspectos de declinação, movimento aplicativo/separativo, orbes personalizados, comparação de casas, uma pontuação de relacionamento de Ciro Discepolo, distribuições de elementos e qualidades, angularidades, stelliums e dignidades essenciais. Os mapas vêm nos estilos Moderno e Clássico com temas clássico, escuro e preto e branco. A instalação requer Python 3.12 ou mais recente via pip. O nível de efemérides revisado padrão usa JPL DE440s cobrindo 1850–2150, com níveis mais amplos disponíveis através do libephemeris. Cálculos offline precisam de longitude, latitude e um fuso horário IANA; o modo online pode resolver localizações através do GeoNames. Uma interface de linha de comando e uma habilidade de agente de IA também são fornecidas. O projeto é licenciado sob AGPL-3.0, com uma API hospedada oferecida para uso comercial de código fechado.