kerykeion

Kerykeion — это библиотека Python для астрологических расчётов и отрисовки SVG-карт. Она вычисляет положения планет, дома, аспекты, возвращения, прогрессии и связанные техники, а затем предоставляет результаты в виде моделей Pydantic, которые можно исследовать в Python, экспортировать в JSON или сериализовать в XML для контекста LLM. По умолчанию используются тропический зодиак, дома Плацидуса и видимые геоцентрические положения. Библиотека разделяет расчёт и представление: AstrologicalSubjectFactory вычисляет небо, дома, точки и происхождение данных; ChartDataFactory добавляет аспекты, распределения, угловость, стеллиумы, оценки отношений и сравнения домов; ChartDrawer отрисовывает уже вычисленные данные в SVG. ReportGenerator создаёт текст, to_context создаёт XML, а model_dump_json создаёт JSON. Поддерживаемые типы карт включают натальные карты и карты событий, синастрию, транзиты, солярные и лунарные возвращения, гелиоцентрические возвращения, пересечения лунных узлов, композит по средним точкам и карты Дэвисона, релокационные карты, вторичные прогрессии и солнечно-дуговые дирекции. Конфигурация охватывает тропический или сидерический зодиак (47 именованных режимов плюс пользовательская аянамша USER), системы домов, полярные резервные варианты домов, видимую/истинную геоцентрическую, топоцентрическую, гелиоцентрическую, барицентрическую и планетоцентрическую перспективы, а также настраиваемый набор активных точек, включая узлы, варианты Лилит, арабские части, астероиды, кентавры, транснептуновые объекты, уранические точки и опциональные неподвижные звёзды. Функции анализа включают аспекты одной и двух карт, аспекты по склонению, аппликацию/сепарацию, пользовательские орбисы, сравнение домов, оценку отношений по Чиро Дишеполо, распределения по стихиям и качествам, угловость, стеллиумы и эссенциальные достоинства. Карты доступны в стилях Modern и Classic с темами classic, dark и black-and-white. Установка требует Python 3.12 или новее через pip. Уровень эфемерид по умолчанию, прошедший проверку, использует JPL DE440s, охватывающий 1850–2150, с более широкими уровнями, доступными через libephemeris. Для офлайн-расчётов нужны долгота, широта и часовой пояс IANA; онлайн-режим может определять местоположения через GeoNames. Также предоставлены интерфейс командной строки и навык AI-агента. Проект лицензирован под AGPL-3.0, а для коммерческого закрытого использования предлагается размещённый API.