Try Astrologer API

Subscribe to support and grow the project.

Kerykeion

Configuration Constants #

Import from: kerykeion.settings.config_constants

This page lists the exhaustive options available for configuring Kerykeion charts.

Celestial Points (AstrologicalPoint) #

When customizing active_points, you can use any of the following string identifiers.

Major Bodies #

  • Sun
  • Moon
  • Mercury
  • Venus
  • Mars
  • Jupiter
  • Saturn
  • Uranus
  • Neptune
  • Pluto

Lunar Nodes #

  • Mean_North_Lunar_Node
  • True_North_Lunar_Node
  • Mean_South_Lunar_Node
  • True_South_Lunar_Node

Lilith & Priapus Variants #

  • Mean_Lilith (mean Black Moon Lilith, lunar apogee averaged)
  • True_Lilith (oscillating Black Moon Lilith)
  • Interpolated_Lilith (interpolated, smoothed between mean and true)
  • Mean_Priapus (mean anti-Lilith, lunar perigee averaged)
  • True_Priapus (oscillating anti-Lilith)

Angles #

  • Ascendant
  • Medium_Coeli
  • Descendant
  • Imum_Coeli
  • Vertex
  • Anti_Vertex

Asteroids & Centaurs #

  • Chiron
  • Ceres
  • Pallas
  • Juno
  • Vesta
  • Pholus

Trans-Neptunian Objects (TNOs) #

  • Eris
  • Sedna
  • Haumea
  • Makemake
  • Ixion
  • Orcus
  • Quaoar

Uranian / Hamburg School (8) #

  • Cupido (relationships, family, art)
  • Hades (hidden things, the past, research)
  • Zeus (directed energy, leadership, fire)
  • Kronos (authority, expertise, height)
  • Apollon (expansion, commerce, science)
  • Admetos (depth, concentration, beginnings/endings)
  • Vulkanus (mighty force, intensity, power)
  • Poseidon (idealism, spirituality, enlightenment)

Special Points #

  • Earth (meaningful in heliocentric perspective)
  • Interpolated_Perigee
  • White_Moon (Selena)

Arabic Parts #

  • Pars_Fortunae (Part of Fortune)
  • Pars_Spiritus (Part of Spirit)
  • Pars_Amoris (Part of Love)
  • Pars_Fidei (Part of Faith)

Fixed Stars #

Fixed stars are not requested through active_points: pass them to the active_fixed_stars parameter of AstrologicalSubjectFactory instead, and read the results from subject.fixed_stars. (Star names passed to active_points are redirected to active_fixed_stars with a warning.) By default no stars are computed.

The 23 names below make up the opt-in DEFAULT_FIXED_STARS preset (smaller presets: ROYAL_FIXED_STARS, BEHENIAN_FIXED_STARS), all importable from kerykeion.settings.config_constants. Use the names as spelled here, spaces included (e.g. Deneb Algedi). The set includes the 4 Royal Stars of Persia (which are a subset of the 15 Behenian stars).

Royal Stars:

  • Regulus (mag +1.35, Royal Star – Heart of Leo)
  • Aldebaran (mag +0.87, Royal Star – Eye of Taurus)
  • Antares (mag +1.06, Royal Star – Heart of Scorpio)
  • Fomalhaut (mag +1.16, Royal Star – Mouth of the Fish)

Behenian Stars:

  • Spica (mag +0.97)
  • Sirius (mag -1.46, brightest star)
  • Vega (mag +0.03)
  • Capella (mag +0.08)
  • Procyon (mag +0.34)
  • Arcturus (mag -0.05)
  • Algol (mag +2.12)
  • Alphecca (mag +2.22)
  • Deneb Algedi (mag +2.83)
  • Alcyone (mag +2.87)
  • Algorab (mag +2.94)

Other Bright Stars:

  • Alkaid (mag +1.86)
  • Canopus (mag -0.74)
  • Rigel (mag +0.13)
  • Betelgeuse (mag +0.42)
  • Achernar (mag +0.46)
  • Altair (mag +0.76)
  • Pollux (mag +1.14)
  • Deneb (mag +1.25)

Each fixed star provides magnitude (apparent visual brightness), declination (equatorial), and speed (daily motion) fields.

Aspect Names (AspectName) #

Identifiers for configuring active_aspects.

Major Aspects #

  • conjunction (0°)
  • opposition (180°)
  • trine (120°)
  • square (90°)
  • sextile (60°)

Minor Aspects #

  • quintile (72°)
  • semi-sextile (30°)
  • semi-square (45°)
  • sesquiquadrate (135°)
  • biquintile (144°)
  • quincunx (150°)

Declination Aspects #

  • parallel (equal declination, same side of the equator)
  • contra-parallel (equal declination, opposite sides)

These two are members of AspectName, but they are not requested through active_aspects: they compare declination rather than ecliptic longitude, so they come from AspectsFactory.single_chart_declination_aspects() and AspectsFactory.dual_chart_declination_aspects(). Passing either name in active_aspects logs a warning and is ignored by the longitude scan.

Default Preset Constants #

These lists are available for quick configuration.

DEFAULT_ACTIVE_POINTS #

Main planets, Chiron, the True North Node, and the Asc/MC angles (14 points).

TRADITIONAL_ASTROLOGY_ACTIVE_POINTS #

Classical planets only plus nodes: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, True North Lunar Node, True South Lunar Node (9 points). Suitable for traditional/Hellenistic astrology.

ALL_ACTIVE_POINTS #

Every point listed above (53 total). Dynamic fixed stars found via FixedStarDiscoveryFactory are added separately and are not part of this preset.

DEFAULT_ACTIVE_ASPECTS #

Conjunction (orb: 6), Opposition (orb: 6), Trine (orb: 6), Square (orb: 6), Sextile (orb: 5). Luminary widening (+1.5° for Sun/Moon) is applied separately via per-point orb adjustments.

ALL_ACTIVE_ASPECTS #

All major and minor aspects listed above, with minor aspects using 2° orbs.

DISCEPOLO_SCORE_ACTIVE_ASPECTS #

Aspect orbs configured for Ciro Discepolo’s relationship scoring methodology: Conjunction (8), Opposition (8), Trine (7), Square (5), Sextile (4), Semi-sextile (2), Semi-square (2), Sesquiquadrate (2). Used internally by RelationshipScoreFactory.