Try Astrologer API

Subscribe to support and grow the project.

You are reading the v5 documentation (legacy). The current release is v6.

Read this page for v6

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", nation="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, nation (str, optional)
  • 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.template)

NatalAspects & SynastryAspects #

Wrappers for AspectsFactory.

from kerykeion import NatalAspects

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