Натальная карта на Python: Swiss Ephemeris, SVG-схемы с карточками по наведению и встроенный Python в архиве

Началось с того, что я хотел посмотреть свою натальную карту и обнаружил, что все удобные сайты ведут одним и тем же путём: регистрация, почта, а расшифровку Луны открывают за подписку. Планеты, как известно, бесплатные, и считаются они давно известными формулами. Поэтому я сделал локальную программу для Windows и назвал «Звёздный паспорт»: Flask на 127.0.0.1, интерфейс в браузере, значок у часов, расчёт на pyswisseph. Исходники открыты: https://github.com/OlegChe77/star-passport .

Расчёт натальной карты оказался самой простой частью (там библиотека делает всю работу). Времени и нервов ушло на другое: сверка с эталоном, схемы, которые нужно сделать понятными, и упаковка так, чтобы человек без Python получил рабочую программу двойным щелчком. Расскажу по порядку.
Что внутри
Шесть вкладок: «Карта» (натальное колесо, таблицы планет и домов), «Числа» (нумерология и квадрат Пифагора), «Матрица судьбы» (22 аркана), «Совместимость» (две карты, связи между планетами, общий балл и четыре сферы), «Сегодня» (Луна, транзиты, биоритмы, Ба-Цзы, разбор дня) и «Полный разбор» (связный текст и все схемы на одной странице для печати).
Стек такой: Python 3.11, Flask, pystray (значок в трее), Pillow (рисование значка), pyswisseph, tzdata. На клиенте ни фреймворков, ни сборщика: SVG на чистом JS, около 1,3 тысячи строк, на сервере около 3,6 тысячи строк Python. Архив 22 МБ, из них основная доля это сам Python и Pillow.
Расчёт: Swiss Ephemeris в режиме Moshier
Для планет я взял pyswisseph в режиме Moshier: он считает по встроенным аналитическим теориям и не требует файлов эфемерид, а точность для натальной карты с запасом. Скорость тоже считается (флаг FLG_SPEED), по ней определяется ретроградность.
import swisseph as swe
FLAGS = swe.FLG_MOSEPH | swe.FLG_SPEED # без файлов эфемерид, со скоростью
# utc — время рождения, приведённое к UTC через zoneinfo
jd = swe.julday(utc.year, utc.month, utc.day,
utc.hour + utc.minute / 60 + utc.second / 3600, swe.GREG_CAL)
for key, body in BODIES: # Солнце, Луна, Меркурий ... Плутон
pos, _ = swe.calc_ut(jd, body, FLAGS) # pos[0] — долгота, pos[3] — её скорость
retro = pos[3] < 0
cusps, ascmc = swe.houses_ex(jd, lat, lon, b'P') # дома Плацидуса; ascmc[0] — ASC, ascmc[1] — MCЧто пришлось учесть:
Дома Плацидуса не определены за полярным кругом (примерно выше 66,5° широты). Для таких городов программа переключается на равные дома (
b'E') и говорит об этом.Времени рождения может не быть. Тогда считаем на полдень, а дома и оси вообще не показываем: показывать их по умолчанию значит нарисовать красивую неправду.
Часовой пояс. На Windows у
zoneinfoнет системной базы, без пакетаtzdata(он вrequirements.txt)ZoneInfo('Europe/Moscow')на чистой машине падает сZoneInfoNotFoundError. Пояс берётся из поиска города (Open-Meteo Geocoding).
Сверка
Планеты я сравнил с NASA JPL Horizons: расхождение меньше 0,001°. Асцендент, MC и дома сверены с независимыми формулами: меньше 0,4′. Это tests/verify_chart.py. Для Луны и Ба-Цзы тоже есть проверки: фазы сверяются с затмениями и формулами Мееса, Ба-Цзы с известными примерами (1 января 2000 и Мао Цзэдун, где все знают ответ). Всего семь скриптов tests/verify_*.py (карта, числа, «Сегодня», совместимость, тексты разбора, карточки, запрос к внешнему сервису), все печатают «ok».
Моменты фаз Луны
Для фаз нужен момент, когда угол Луна−Солнце равен заданному. Решается итерацией: берём среднюю скорость расхождения (синодический месяц) и подтягиваем по невязке, пока она не станет меньше 1e-7 градуса:
def phase_jd(jd, target, forward=True):
"""Момент (JD, UT), когда elongation равен target: ближайший после jd (forward) или до него."""
e = elongation(jd)
d = (target - e) % 360 if forward else -((e - target) % 360)
t = jd + d / SYNODIC_RATE
for _ in range(20):
diff = (target - elongation(t) + 540) % 360 - 180
if abs(diff) < 1e-7:
break
t += diff / SYNODIC_RATE
return tТрюк (x + 540) % 360 - 180 приводит разность углов к диапазону ±180, иначе на переходе через 0° итерация уезжает на целый круг.
Числа и «авторские» методики
Нумерология и квадрат Пифагора считаются без внешних библиотек. Мелочи, которые стоили мне времени: для рождённых после 2000 года классическая формула квадрата Пифагора перестаёт работать, и «третье рабочее число» приходится считать как первое плюс 19; Ъ и Ь в именах не считаются; мастер-числа 11 и 22 сохраняются, а личный год всегда в цикле 1–9. С матрицей судьбы сложнее: методик много и они расходятся, поэтому у каждого числа в ответе API есть поле how («как получено»), и страница показывает его под схемой. Если вы считаете иначе, видно, где именно мы расходимся.

Схемы: SVG и карточки по наведению
Все схемы это SVG, собранный JS-модулями из общих «кирпичиков» (CHART.kit): колесо, шарики-планеты, рамки, фон со звёздами. Вся картинка рисуется на клиенте по JSON от сервера.
Главная для меня была не красота, а то, чтобы человек, увидевший значок «☿» в третьем доме, мог узнать, что это. Поэтому поверх схемы лежат невидимые зоны .hit с атрибутом data-x=ключ, а сервер (explain.py) отдаёт словарь карточек: заголовок, подзаголовок, абзацы, тон. Их около 300, они собираются под конкретного человека: «Венера в Тельце в седьмом доме» превращается в текст про вас, а не про всех сразу.
Несколько ловушек, на которые наступил:
Нельзя ставить на
.hitpointer-events: all: у кривых (биоритмы, линии аспектов) залипает вся внутренняя область, а не линия.Порядок слоёв важен: более частное должно быть позже общего (строка таблицы, потом знак, потом дом).
На телефоне нет наведения, поэтому касание ищет ближайшую зону в радиусе 16 пикселей, мелкие вперёд.
При экспорте и в «Сохранить HTML» зоны и
data-xнадо вырезать (EXPLAIN.strip), иначе в PNG останется мусор.
Читаемость я доводил отдельно: основной текст сначала получился мелковатым, поэтому поднял его до 19 px, а для SVG написал LEGIBLE.fix, который после вставки схемы подтягивает кегль не ниже доли от её ширины, поднимает контраст и ищет пересечения подписей через getBBox(). Правило «пересечений ноль» проверяется скриптом на всех вкладках.

Экспорт: PNG и PDF без бэкенда
Схема в PNG и PDF сохраняется прямо в браузере. SVG на странице ссылается на градиенты из общих , на классы стилей и на шрифты, поэтому просто сериализовать его нельзя: файл потеряет вид. export.js вшивает в копию SVG определения, правила классов и шрифты woff2 в base64, рисует её на canvas шириной 2400 px и отдаёт PNG. PDF собирается самодельным buildPdf: страница равна схеме, внутри JPEG. Готовая схема весит 2–7 МБ в PNG, весь паспорт в PDF около 5 МБ.
«Полный разбор» (/report) использует те же модули, а объяснения под схемами берёт из index.html (figcaption по data-kind), чтобы текст жил в одном месте. Печать это отдельная светлая вёрстка в @media print: чёрный текст, страница на раздел. Проверить её без принтера можно, вставив содержимое @media print как обычный CSS и сузив окно до 720 px.

Встроенный Python, порт и заставка
Это та часть, из-за которой у «программ на Python для обычных людей» плохая репутация, поэтому остановлюсь подробнее.
Python лежит в архиве. python\ с embeddable Python 3.11.9, pip и пакетами из requirements.txt входит в star-passport.zip, ничего не скачивается при первом запуске. Скачивание остаётся запасным путём, если папка повреждена: я проверил, что после удаления flask она восстанавливается за 10 секунд, после удаления python311.dll Python скачивается заново за 20.
Почему именно 3.11, а не 3.12. У pyswisseph на PyPI нет колёс под Windows для 3.12 и новее, а компилятора у обычных пользователей нет. Поэтому версия закреплена.
Порт. Программа слушает 8770, но этот порт может быть занят чем угодно. Если он занят чужой программой, берётся ближайший свободный из следующих тридцати, а наша копия потом находится по файлу cache/port.txt. Забавная мелочь Windows: connect на закрытый порт ждёт около двух секунд, а проверка через bind мгновенна, поэтому подключаться я пробую только к уже занятым портам:
def pick_port(preferred):
for port in range(preferred, min(preferred + 30, 65536)):
if can_bind(port): # свободен: bind мгновенный
return port
if probe_port(port, 3) == 'ours': # занят нашей копией: не запускаем вторую
return port
return preferredЗаставка. Запуск до готовности страницы занимает пару секунд, и пустота при двойном щелчке выглядит как «не запустилось». launch.vbs показывает окошко «Запускается…» на mshta, а программа пишет cache/ready.txt после открытия страницы; заставка закрывается сама, как только файл появился.
Самообновление с версии 1.0. updater.py сверяет releases/latest на GitHub, скачивает архив (предпочитает star-passport-update.zip без Python, около 0,9 МБ), проверяет SHA-256, подменяет файлы отдельным процессом и откатывается, если новая версия не стартовала. settings.json, python и кэш не трогаются.
Приватность
Расчёт локальный. В интернет уходят: название города (поиск координат), по галочке дополнение разбора (знаки, дома, градусы и числа без имени, даты, времени и города; тест tests/verify_ai.py проверяет, что лишнего в запросе нет) и раз в три дня проверка версии. Данные лежат в settings.json, есть кнопка «Забыть данные».
Сколько это весит и на что похоже вживую
Для интереса снял замеры на копии программы без значка в трее (Windows 10, встроенный Python): холодный старт до ответа /api/status около 2,5 секунды, процесс держит около 60 МБ рабочего набора. Расчёт карты по запросу 5 мс, числа 2 мс, «Сегодня» 4 мс, совместимость 5 мс, а «Полный разбор» целиком (все данные, около 300 карточек, 600 КБ JSON) 9 мс. Бутылочное горлышко здесь не математика, а браузер, который рисует SVG.
Ссылки
Скачать: https://github.com/OlegChe77/star-passport/releases/latest/download/star-passport.zip
Исходники: https://github.com/OlegChe77/star-passport
Если вы нашли расхождение с другой программой по какой-нибудь планете или дому, пишите в комментариях или в Issues: сверю и поправлю.
KioskNews shows a cleaned-up reading view extracted from the publisher’s page — the original always lives on their site, not ours.