Try Astrologer API

Subscribe to support and grow the project.

Legacy API (Backward Compatibility) #

Kerykeion v5 introduces a new factory-based architecture. However, to support existing codebases, the library includes a backward compatibility layer defined in kerykeion.backword.

AstrologicalSubject (Legacy Wrapper) #

A wrapper class that emulates the behavior of the old AstrologicalSubject class.

# Legacy usage (still works but issues warning)
from kerykeion import AstrologicalSubject

subject = AstrologicalSubject(
    "Alice", 1990, 5, 15, 10, 30,
    city="London", nat="GB"
)
print(subject.sun["sign"])

Constructor #

The constructor signature attempts to match v4, forwarding arguments to AstrologicalSubjectFactory.from_birth_data.

  • name (str)
  • year, month, day, hour, minute (int)
  • lng, lat (float, optional)
  • tz_str (str, optional)
  • city, nat (str, optional): nat is mapped to nation.
  • online (bool)

KerykeionChartSVG (Legacy Wrapper) #

Wrapper for the chart generation logic, delegating to ChartDrawer.

from kerykeion import KerykeionChartSVG

chart = KerykeionChartSVG(subject)
chart.makeSVG()
print(chart.content)

NatalAspects & SynastryAspects #

Wrappers for AspectsFactory.

from kerykeion import NatalAspects

aspects = NatalAspects(subject)
for aspect in aspects.aspects:
    print(aspect)