kerykeion

Kerykeion은 점성술 계산 및 SVG 차트 렌더링을 위한 Python 라이브러리입니다. 행성 위치, 하우스, 애스펙트, 리턴, 프로그레션 및 관련 기법을 계산한 뒤, 그 결과를 Pydantic 모델로 노출하여 Python에서 검사하거나 JSON으로 내보내거나 LLM 컨텍스트용 XML로 직렬화할 수 있습니다. 기본값은 열대 황도대, Placidus 하우스, 겉보기 지구중심 위치를 사용합니다. 이 라이브러리는 계산과 표현을 분리합니다. AstrologicalSubjectFactory는 하늘, 하우스, 포인트 및 출처 정보를 계산하고, ChartDataFactory는 애스펙트, 분포, 각도성, 스텔리움, 관계 점수 및 하우스 비교를 추가하며, ChartDrawer는 이미 계산된 데이터를 SVG로 렌더링합니다. ReportGenerator는 텍스트를 생성하고, to_context는 XML을 생성하며, model_dump_json은 JSON을 생성합니다. 지원되는 차트 유형에는 출생 및 이벤트 차트, 시나스트리, 트랜짓, 태양 및 태음 리턴, 태양중심 리턴, 월교점 통과, 중간점 컴포지트 및 Davison 차트, 재배치 차트, 이차 프로그레션 및 태양호 방향이 포함됩니다. 구성은 열대 또는 항성 황도대(47개의 명명된 모드와 사용자 정의 USER 아야남사), 하우스 시스템, 극지 하우스 폴백, 겉보기/진 지구중심, 지표중심, 태양중심, 질량중심 및 행성중심 관점, 그리고 노드, Lilith 변형, 아랍 파트, 소행성, 켄타우로스, 해왕성 너머 천체, Uranian 포인트 및 선택적 항성을 포함하는 구성 가능한 활성 포인트 세트를 다룹니다. 분석 기능에는 단일 및 이중 차트 애스펙트, 적위 애스펙트, 적용/분리 운동, 사용자 정의 오브, 하우스 비교, Ciro Discepolo 관계 점수, 원소 및 특성 분포, 각도성, 스텔리움 및 본질적 위계가 포함됩니다. 차트는 Modern 및 Classic 스타일로 제공되며, classic, dark 및 black-and-white 테마가 있습니다. 설치에는 pip를 통한 Python 3.12 이상이 필요합니다. 기본 검토된 천문력 계층은 1850–2150을 포괄하는 JPL DE440s를 사용하며, 더 넓은 계층은 libephemeris를 통해 사용할 수 있습니다. 오프라인 계산에는 경도, 위도 및 IANA 시간대가 필요하며, 온라인 모드는 GeoNames를 통해 위치를 확인할 수 있습니다. 명령줄 인터페이스와 AI 에이전트 스킬도 제공됩니다. 이 프로젝트는 AGPL-3.0 라이선스이며, 상업적 폐쇄 소스 사용을 위한 호스팅 API가 제공됩니다.