kerykeion 4.0.3__py3-none-any.whl → 4.8.1__py3-none-any.whl

kerykeion/charts/templates/chart.xml

@@ -1,7 +1,5 @@
 <?xml version='1.0' encoding='UTF-8'?>
-<!DOCTYPE svg PUBLIC '-//W3C//DTD SVG 1.1//EN' 'http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd'>
-<!---
-This file is part of Kerykeion and is based on OpenAstro.org -->
+<!--- This file is part of Kerykeion and is based on OpenAstro.org -->
 <svg
     xmlns="http://www.w3.org/2000/svg"
     xmlns:xlink="http://www.w3.org/1999/xlink"
@@ -10,11 +8,11 @@ This file is part of Kerykeion and is based on OpenAstro.org -->
     viewBox="$viewbox"
     preserveAspectRatio="xMidYMid"
 >
-    <title>Kerykeion</title>
+    <title>$stringTitle | Kerykeion</title>
     <g transform="translate($cfgTranslate)">
         <g transform="rotate($cfgRotate)">
             <g transform="scale($cfgZoom)">
-                <rect x="0" y="0" width="$chart_width" height="546.0" style="fill: $paper_color_1" />
+                <rect class="background-rectangle" x="0" y="0" width="$chart_width" height="$chart_height" style="fill: $paper_color_1" />
                 <text x="20" y="30" style="fill: $paper_color_0; font-size: 24px">$stringTitle</text>
                 <text x="20" y="50" style="fill: $paper_color_0; font-size: 11px">$stringName</text>
                 <text x="20" y="62" style="fill: $paper_color_0; font-size: 11px">$stringLocation</text>
@@ -469,20 +467,49 @@ This file is part of Kerykeion and is based on OpenAstro.org -->
                 </symbol>
                 <g transform="translate(50,50)">
                     <g transform="translate($circleX,$circleY)">
-                        <!-- Zodiac -->$makeZodiac <!-- First Circle -->
-                        <circle $c1 style="$c1style" />
+                        <!-- Zodiac -->
+                        $makeZodiac 
+
+                        <!-- First Circle -->
+                        $first_circle
+
                         <!-- Second Circle -->
-                        <circle
-                            $c2 style="$c2style" />
+                        $second_circle
+
                         <!-- Third Circle -->
                         <circle $c3 style="$c3style" />
-                        <!-- TransitRing -->$transitRing <!-- Degree Ring -->$degreeRing <!-- Houses -->
-                    $makeHouses
-                        <!-- Planets -->$makePlanets <!-- Aspects -->$makeAspects </g>
-                    <!-- makePatterns -->$makePatterns <!-- AspectGrid -->
+
+                        <!-- TransitRing -->
+                        $transitRing 
+
+                        <!-- Degree Ring -->
+                        $degreeRing
+
+                        <!-- Houses -->
+                        $makeHouses
+
+                        <!-- Planets -->
+                        $makePlanets
+
+                        <!-- Aspects -->
+                        $makeAspects 
+                    </g>
+
+                    <!-- makePatterns -->
+                    $makePatterns
+
+                    <!-- AspectGrid -->
                     $makeAspectGrid
-                    <!-- Elements -->$makeElements <!-- Planet Grid -->$makePlanetGrid <!-- Houses Grid -->
+
+                    <!-- Elements -->
+                    $elements_percentages 
+
+                    <!-- Planet Grid -->
+                    $makePlanetGrid
+
+                    <!-- Houses Grid -->
                     $makeHousesGrid
+
                 </g>
             </g>
         </g>

kerykeion/enums.py

@@ -0,0 +1,50 @@
+from enum import Enum
+
+
+class Planets(Enum):
+    SUN = "Sun"
+    MOON = "Moon"
+    MERCURY = "Mercury"
+    VENUS = "Venus"
+    MARS = "Mars"
+    JUPITER = "Jupiter"
+    SATURN = "Saturn"
+    URANUS = "Uranus"
+    NEPTUNE = "Neptune"
+    PLUTO = "Pluto"
+    CHIRON = "Chiron"
+    TRUE_NODE = "True_Node"
+    MEAN_NODE = "Mean_Node"
+
+
+class Aspects(Enum):
+    CONJUNCTION = "Conjunction"
+    SEXTILE = "Sextile"
+    SEMI_SEXTILE = "Semi-Sextile"
+    SQUARE = "Square"
+    TRINE = "Trine"
+    OPPOSITION = "Opposition"
+    QUINCUNX = "Quincunx"
+    NONE = None
+    QUINTILE = "Quintile"
+    BIQUINTILE = "Biquintile"
+    OCTILE = "Octile"
+    TRIOCTILE = "Trioctile"
+    DECILE = "Decile"
+    TRIDECILE = "Tridecile"
+    SESQUIQUADRATE = "Sesquiquadrate"
+
+
+class Signs(Enum):
+    ARI = "Ari"
+    TAU = "Tau"
+    GEM = "Gem"
+    CAN = "Can"
+    LEO = "Leo"
+    VIR = "Vir"
+    LIB = "Lib"
+    SCO = "Sco"
+    SAG = "Sag"
+    CAP = "Cap"
+    AQU = "Aqu"
+    PIS = "Pis"

kerykeion/fetch_geonames.py

@@ -1,22 +1,15 @@
 # -*- coding: utf-8 -*-
 """
-    This is part of Kerykeion (C) 2023 Giacomo Battaglia
+    This is part of Kerykeion (C) 2024 Giacomo Battaglia
 """
 
 
-from logging import getLogger, basicConfig
+import logging
 from requests import Request
 from requests_cache import CachedSession
 from typing import Union
 
 
-logger = getLogger(__name__)
-basicConfig(
-    format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
-    level="INFO"
-)
-
-
 class FetchGeonames:
     """
     Class to handle requests to the GeoNames API
@@ -25,8 +18,6 @@ class FetchGeonames:
     city_name (str): Name of the city
     country_code (str): Two letters country code
     username (str, optional): GeoNames username, defaults to "century.boy".
-    logger (Union[logging.Logger, None], optional):
-        Optional logger, defaults to None. If none provided creates one.
     """
 
     def __init__(
@@ -57,21 +48,21 @@ class FetchGeonames:
         params = {"lat": lat, "lng": lon, "username": self.username}
 
         prepared_request = Request("GET", self.timezone_url, params=params).prepare()
-        logger.debug(f"Requesting data from GeoName timezones: {prepared_request.url}")
+        logging.debug(f"Requesting data from GeoName timezones: {prepared_request.url}")
 
         try:
             response = self.session.send(prepared_request)
             response_json = response.json()
 
         except Exception as e:
-            logger.error(f"Error fetching {self.timezone_url}: {e}")
+            logging.error(f"Error fetching {self.timezone_url}: {e}")
             return {}
 
         try:
             timezone_data["timezonestr"] = response_json["timezoneId"]
 
         except Exception as e:
-            logger.error(f"Error serializing data maybe wrong username? Details: {e}")
+            logging.error(f"Error serializing data maybe wrong username? Details: {e}")
             return {}
 
         if hasattr(response, "from_cache"):
@@ -91,18 +82,21 @@ class FetchGeonames:
             "contry": country_code,
             "username": self.username,
             "maxRows": 1,
-            "style": "FULL",
+            "style": "SHORT",
+            "featureClass": "A",
+            "featureClass": "P",
         }
 
         prepared_request = Request("GET", self.base_url, params=params).prepare()
-        logger.debug(f"Requesting data from geonames basic: {prepared_request.url}")
+        logging.debug(f"Requesting data from geonames basic: {prepared_request.url}")
 
         try:
             response = self.session.send(prepared_request)
             response_json = response.json()
+            logging.debug(f"Response from GeoNames: {response_json}")
 
         except Exception as e:
-            logger.error(f"Error in fetching {self.base_url}: {e}")
+            logging.error(f"Error in fetching {self.base_url}: {e}")
             return {}
 
         try:
@@ -112,7 +106,7 @@ class FetchGeonames:
             city_data_whitout_tz["countryCode"] = response_json["geonames"][0]["countryCode"]
 
         except Exception as e:
-            logger.error(f"Error serializing data maybe wrong username? Details: {e}")
+            logging.error(f"Error serializing data maybe wrong username? Details: {e}")
             return {}
 
         if hasattr(response, "from_cache"):
@@ -132,18 +126,15 @@ class FetchGeonames:
             timezone_response = self.__get_timezone(city_data_response["lat"], city_data_response["lng"])
 
         except Exception as e:
-            logger.error(f"Error in fetching timezone: {e}")
+            logging.error(f"Error in fetching timezone: {e}")
             return {}
 
         return {**timezone_response, **city_data_response}
 
 
 if __name__ == "__main__":
-    basicConfig(
-        format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
-        level="DEBUG",
-        force=True,
-    )
+    from kerykeion.utilities import setup_logging
+    setup_logging(level="debug")
 
-    geonames = FetchGeonames("Roma", "IT")
+    geonames = FetchGeonames("Montichiari", "IT")
     print(geonames.get_serialized_data())

kerykeion/kr_types/__init__.py

@@ -1,3 +1,10 @@
+# -*- coding: utf-8 -*-
+"""
+    This is part of Kerykeion (C) 2024 Giacomo Battaglia
+"""
+
 from .kerykeion_exception import KerykeionException
 from .kr_literals import *
 from .kr_models import *
+from .chart_types import ChartTemplateDictionary
+from .settings_models import KerykeionSettingsModel

kerykeion/kr_types/chart_types.py

@@ -1,32 +1,22 @@
-from typing import Literal, Union, Optional
-from pydantic import BaseModel
+from typing import TypedDict
 
 
-class ChartTemplateModel(BaseModel):
-    """Pydantic model for the chart template."""
-
-    def __setitem__(self, key, value):
-        setattr(self, key, value)
-
-    def __getitem__(self, key):
-        return getattr(self, key)
-
+class ChartTemplateDictionary(TypedDict):
     transitRing: str
     degreeRing: str
-    c1: str
-    c1style: str
-    c2: str
-    c2style: str
+    first_circle: str
+    second_circle: str
     c3: str
     c3style: str
-    makeAspects: bool
-    makeAspectGrid: bool
-    makePatterns: bool
-    chart_width: int
-    circleX: int
-    circleY: int
-    svgWidth: int
-    svgHeight: int
+    makeAspects: str
+    makeAspectGrid: str
+    makePatterns: str
+    chart_height: float
+    chart_width: float
+    circleX: str
+    circleY: str
+    svgWidth: str
+    svgHeight: str
     viewbox: str
     stringTitle: str
     stringName: str
@@ -39,14 +29,19 @@ class ChartTemplateModel(BaseModel):
     lunar_phase_cx: int
     lunar_phase_r: int
     lunar_phase_outline: str
-    lunar_phase_rotate: int
+    lunar_phase_rotate: float
     stringLocation: str
     stringDateTime: str
     stringLat: str
     stringLon: str
     stringPosition: str
+
+    # Font color
     paper_color_0: str
+    # Background color of the chart
     paper_color_1: str
+    
+    # Planets colors, from 1 to 15 (0 is the Sun)
     planets_color_0: str
     planets_color_1: str
     planets_color_2: str
@@ -63,6 +58,8 @@ class ChartTemplateModel(BaseModel):
     planets_color_13: str
     planets_color_14: str
     planets_color_15: str
+    
+    # Zodiac colors, from 0 to 11 (0 is Aries)
     zodiac_color_0: str
     zodiac_color_1: str
     zodiac_color_2: str
@@ -75,6 +72,8 @@ class ChartTemplateModel(BaseModel):
     zodiac_color_9: str
     zodiac_color_10: str
     zodiac_color_11: str
+
+    # Aspects colors, from 0 to 9 (0 is conjunction)
     orb_color_0: str
     orb_color_30: str
     orb_color_45: str
@@ -86,12 +85,13 @@ class ChartTemplateModel(BaseModel):
     orb_color_144: str
     orb_color_150: str
     orb_color_180: str
-    cfgZoom: float
-    cfgRotate: int
+
+    cfgZoom: str
+    cfgRotate: str
     cfgTranslate: str
-    makeZodiac: bool
-    makeHouses: bool
-    makePlanets: bool
-    makeElements: bool
-    makePlanetGrid: bool
-    makeHousesGrid: bool
+    makeZodiac: str
+    makeHouses: str
+    makePlanets: str
+    elements_percentages: str
+    makePlanetGrid: str
+    makeHousesGrid: str

kerykeion/kr_types/kerykeion_exception.py

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-    This is part of Kerykeion (C) 2023 Giacomo Battaglia
+    This is part of Kerykeion (C) 2024 Giacomo Battaglia
 """
 
 

kerykeion/kr_types/kr_literals.py

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-    This is part of Kerykeion (C) 2023 Giacomo Battaglia
+    This is part of Kerykeion (C) 2024 Giacomo Battaglia
 """
 
 
@@ -56,3 +56,13 @@ Quality = Literal[
 ChartType = Literal["Natal", "ExternalNatal", "Synastry", "Transit"]
 
 LunarPhaseEmoji = Literal["🌑", "🌒", "🌓", "🌔", "🌕", "🌖", "🌗", "🌘"]
+LunarPhaseName = Literal[
+        "New Moon", 
+        "Waxing Crescent", 
+        "First Quarter", 
+        "Waxing Gibbous", 
+        "Full Moon", 
+        "Waning Gibbous", 
+        "Last Quarter", 
+        "Waning Crescent"
+    ]

kerykeion/kr_types/kr_models.py

@@ -1,25 +1,26 @@
 # -*- coding: utf-8 -*-
 """
-    This is part of Kerykeion (C) 2023 Giacomo Battaglia
+    This is part of Kerykeion (C) 2024 Giacomo Battaglia
 """
 
 
 from typing import Literal, Union, Optional
 from pydantic import BaseModel
 
-from .kr_literals import *
+from kerykeion.kr_types import LunarPhaseEmoji, LunarPhaseName, Planet, Houses, Quality, Element, Sign, ZodiacType
 
 
 class LunarPhaseModel(BaseModel):
-    degrees_between_s_m: Union[int, float]
+    degrees_between_s_m: Union[float, int]
     moon_phase: int
     sun_phase: int
     moon_emoji: LunarPhaseEmoji
+    moon_phase_name: LunarPhaseName
 
     def __str__(self):
         return (
             super()
-            .dict(
+            .model_dump(
                 exclude_none=True,
                 exclude_unset=True,
                 exclude_defaults=True,
@@ -31,7 +32,7 @@ class LunarPhaseModel(BaseModel):
     def __repr__(self):
         return (
             super()
-            .dict(
+            .model_dump(
                 exclude_none=True,
                 exclude_unset=True,
                 exclude_defaults=True,
@@ -73,7 +74,7 @@ class KerykeionPointModel(BaseModel):
     def __str__(self):
         return (
             super()
-            .dict(
+            .model_dump(
                 exclude_none=True,
                 exclude_unset=True,
                 exclude_defaults=True,
@@ -85,7 +86,7 @@ class KerykeionPointModel(BaseModel):
     def __repr__(self):
         return (
             super()
-            .dict(
+            .model_dump(
                 exclude_none=True,
                 exclude_unset=True,
                 exclude_defaults=True,
@@ -136,6 +137,7 @@ class AstrologicalSubjectModel(BaseModel):
     uranus: KerykeionPointModel
     neptune: KerykeionPointModel
     pluto: KerykeionPointModel
+    chiron: Union[KerykeionPointModel, None]
 
     # Houses
     first_house: KerykeionPointModel
@@ -160,6 +162,10 @@ class AstrologicalSubjectModel(BaseModel):
 
 
 if __name__ == "__main__":
+    from kerykeion.utilities import setup_logging
+
+    setup_logging(level="debug")
+
     sun = KerykeionPointModel(
         name="Sun",
         element="Air",
@@ -172,5 +178,5 @@ if __name__ == "__main__":
         point_type="Planet",
     )
 
-    print(sun.json())
+    print(sun.model_dump_json())
     print(sun)

kerykeion/kr_types/settings_models.py

@@ -0,0 +1,180 @@
+# -*- coding: utf-8 -*-
+"""
+    This is part of Kerykeion (C) 2024 Giacomo Battaglia
+"""
+
+
+from pydantic import BaseModel, Field
+from typing import List
+
+
+class CustomBaseModel(BaseModel):
+    """
+    Extends the BaseModel class of Pydantic to add some useful methods.
+    """
+
+    def __init__(self, **data):
+        super().__init__(**data)
+
+    def __getitem__(self, item):
+        return getattr(self, item)
+    
+    def __str__(self) -> str:
+        return str(self.model_dump())
+
+    def get(self, item, default=None):
+        return getattr(self, item, default)
+
+
+class KerykeionSettingsCelestialPointModel(CustomBaseModel):
+    """
+    Defines the model for a celestial point data.
+    """
+
+    id: int = Field(title="Celestial Point ID", description="Celestial Point ID according to Pyswisseph")
+    name: str = Field(title="Celestial Point Name", description="Celestial Point Name")
+    color: str = Field(title="Celestial Point Color", description="Celestial Point Color, used in the chart")
+    is_active: bool = Field(title="Celestial Point is Active", description="Indicates if the celestial point is active in the chart")
+    element_points: int = Field(title="Celestial Point Element Points", description="Element Points given to the celestial point")
+    related_zodiac_signs: List[int] = Field(title="Celestial Point Related Zodiac Signs", description="Zodiac Signs related to the celestial point")
+    label: str = Field(title="Celestial Point Label", description="The name of the celestial point in the chart, it can be different from the name")
+
+
+# Chart Colors Settings
+class KerykeionSettingsChartColorsModel(CustomBaseModel):
+    """
+    Defines the model for the chart colors.
+    """
+
+    paper_0: str = Field(title="Paper Color 0", description="Paper Color 0")
+    paper_1: str = Field(title="Paper Color 1", description="Paper Color 1")
+    zodiac_bg_0: str = Field(title="Zodiac Background Color 0", description="Zodiac Background Color 0")
+    zodiac_bg_1: str = Field(title="Zodiac Background Color 1", description="Zodiac Background Color 1")
+    zodiac_bg_2: str = Field(title="Zodiac Background Color 2", description="Zodiac Background Color 2")
+    zodiac_bg_3: str = Field(title="Zodiac Background Color 3", description="Zodiac Background Color 3")
+    zodiac_bg_4: str = Field(title="Zodiac Background Color 4", description="Zodiac Background Color 4")
+    zodiac_bg_5: str = Field(title="Zodiac Background Color 5", description="Zodiac Background Color 5")
+    zodiac_bg_6: str = Field(title="Zodiac Background Color 6", description="Zodiac Background Color 6")
+    zodiac_bg_7: str = Field(title="Zodiac Background Color 7", description="Zodiac Background Color 7")
+    zodiac_bg_8: str = Field(title="Zodiac Background Color 8", description="Zodiac Background Color 8")
+    zodiac_bg_9: str = Field(title="Zodiac Background Color 9", description="Zodiac Background Color 9")
+    zodiac_bg_10: str = Field(title="Zodiac Background Color 10", description="Zodiac Background Color 10")
+    zodiac_bg_11: str = Field(title="Zodiac Background Color 11", description="Zodiac Background Color 11")
+    zodiac_icon_0: str = Field(title="Zodiac Icon Color 0", description="Zodiac Icon Color 0")
+    zodiac_icon_1: str = Field(title="Zodiac Icon Color 1", description="Zodiac Icon Color 1")
+    zodiac_icon_2: str = Field(title="Zodiac Icon Color 2", description="Zodiac Icon Color 2")
+    zodiac_icon_3: str = Field(title="Zodiac Icon Color 3", description="Zodiac Icon Color 3")
+    zodiac_icon_4: str = Field(title="Zodiac Icon Color 4", description="Zodiac Icon Color 4")
+    zodiac_icon_5: str = Field(title="Zodiac Icon Color 5", description="Zodiac Icon Color 5")
+    zodiac_icon_6: str = Field(title="Zodiac Icon Color 6", description="Zodiac Icon Color 6")
+    zodiac_icon_7: str = Field(title="Zodiac Icon Color 7", description="Zodiac Icon Color 7")
+    zodiac_icon_8: str = Field(title="Zodiac Icon Color 8", description="Zodiac Icon Color 8")
+    zodiac_icon_9: str = Field(title="Zodiac Icon Color 9", description="Zodiac Icon Color 9")
+    zodiac_icon_10: str = Field(title="Zodiac Icon Color 10", description="Zodiac Icon Color 10")
+    zodiac_icon_11: str = Field(title="Zodiac Icon Color 11", description="Zodiac Icon Color 11")
+    zodiac_radix_ring_0: str = Field(title="Zodiac Radix Ring Color 0", description="Zodiac Radix Ring Color 0")
+    zodiac_radix_ring_1: str = Field(title="Zodiac Radix Ring Color 1", description="Zodiac Radix Ring Color 1")
+    zodiac_radix_ring_2: str = Field(title="Zodiac Radix Ring Color 2", description="Zodiac Radix Ring Color 2")
+    zodiac_transit_ring_0: str = Field(title="Zodiac Transit Ring Color 0", description="Zodiac Transit Ring Color 0")
+    zodiac_transit_ring_1: str = Field(title="Zodiac Transit Ring Color 1", description="Zodiac Transit Ring Color 1")
+    zodiac_transit_ring_2: str = Field(title="Zodiac Transit Ring Color 2", description="Zodiac Transit Ring Color 2")
+    zodiac_transit_ring_3: str = Field(title="Zodiac Transit Ring Color 3", description="Zodiac Transit Ring Color 3")
+    houses_radix_line: str = Field(title="Houses Radix Line Color", description="Houses Radix Line Color")
+    houses_transit_line: str = Field(title="Houses Transit Line Color", description="Houses Transit Line Color")
+    lunar_phase_0: str = Field(title="Lunar Phase Color 0", description="Lunar Phase Color 0")
+    lunar_phase_1: str = Field(title="Lunar Phase Color 1", description="Lunar Phase Color 1")
+    lunar_phase_2: str = Field(title="Lunar Phase Color 2", description="Lunar Phase Color 2")
+
+
+# Aspect Settings
+class KerykeionSettingsAspectModel(CustomBaseModel):
+    """
+    Defines the model for an aspect.
+    """
+
+    degree: int = Field(title="Aspect Degrees", description="The degree of the aspect")
+    name: str = Field(title="Aspect Name", description="The name of the aspect")
+    is_active: bool = Field(title="Aspect is Active", description="Is the aspect active?")
+    visible_grid: bool = Field(title="Aspect Visible Grid", description="Is the aspect visible in the grid?")
+    is_major: bool = Field(title="Aspect is Major", description="Is the aspect major?")
+    is_minor: bool = Field(title="Aspect is Minor", description="Is the aspect minor?")
+    orb: int = Field(title="Aspect Orb", description="The orb of the aspect")
+    color: str = Field(title="Aspect Color", description="The color of the aspect")
+
+
+# Language Settings
+class KerykeionLanguageCelestialPointModel(CustomBaseModel):
+    """
+    This class is used to define the labels, show in the chart, for the celestial points.
+    It is used to translate the celestial points in the language of the chart.
+    """
+
+    Sun: str = Field(title="Sun", description="The name of the Sun in the chart, in the language")
+    Moon: str = Field(title="Moon", description="The name of the Moon in the chart, in the language")
+    Mercury: str = Field(title="Mercury", description="The name of Mercury in the chart, in the language")
+    Venus: str = Field(title="Venus", description="The name of Venus in the chart, in the language")
+    Mars: str = Field(title="Mars", description="The name of Mars in the chart, in the language")
+    Jupiter: str = Field(title="Jupiter", description="The name of Jupiter in the chart, in the language")
+    Saturn: str = Field(title="Saturn", description="The name of Saturn in the chart, in the language")
+    Uranus: str = Field(title="Uranus", description="The name of Uranus in the chart, in the language")
+    Neptune: str = Field(title="Neptune", description="The name of Neptune in the chart, in the language")
+    Pluto: str = Field(title="Pluto", description="The name of Pluto in the chart, in the language")
+    True_Node: str = Field(title="True Node", description="The name of True Node in the chart, in the language")
+    Mean_Node: str = Field(title="Mean Node", description="The name of Mean Node in the chart, in the language")
+    Chiron: str = Field(title="Chiron", description="The name of Chiron in the chart, in the language")
+    Asc: str = Field(title="Ascendant", description="The name of Ascendant in the chart, in the language")
+    Mc: str = Field(title="Medium Coeli", description="The name of Medium Coeli in the chart, in the language")
+    Dsc: str = Field(title="Descendant", description="The name of Descendant in the chart, in the language")
+    Ic: str = Field(title="Imum Coeli", description="The name of Imum Coeli in the chart, in the language")
+
+
+class KerykeionLanguageModel(CustomBaseModel):
+    """
+    This model is used to store the language settings for the chart,
+    it's used to translate the celestial points and the other labels
+    """
+
+    info: str = Field(title="Info", description="The name of the Info label in the chart, in the language")
+    cusp: str = Field(title="Cusp", description="The name of the Cusp label in the chart, in the language")
+    longitude: str = Field(title="Longitude", description="The name of the Longitude label in the chart, in the language")
+    latitude: str = Field(title="Latitude", description="The name of the Latitude label in the chart, in the language")
+    north: str = Field(title="North", description="The name of the North label in the chart, in the language")
+    east: str = Field(title="East", description="The name of the East label in the chart, in the language")
+    south: str = Field(title="South", description="The name of the South label in the chart, in the language")
+    west: str = Field(title="West", description="The name of the West label in the chart, in the language")
+    fire: str = Field(title="Fire", description="The name of the Fire label in the chart, in the language")
+    earth: str = Field(title="Earth", description="The name of the Earth label in the chart, in the language")
+    air: str = Field(title="Air", description="The name of the Air label in the chart, in the language")
+    water: str = Field(title="Water", description="The name of the Water label in the chart, in the language")
+    and_word: str = Field(title="And", description="The name of the And word in the chart, in the language")
+    transits: str = Field(title="Transits", description="The name of the Transits label in the chart, in the language")
+    type: str = Field(title="Type", description="The name of the Type label in the chart, in the language")
+    aspects: str = Field(title="Aspects", description="The name of the Aspects label in the chart, in the language")
+    planets_and_house: str = Field(title="Planets and Houses", description="The name of the Planets and Houses label in the chart, in the language")
+    transit_name: str = Field(title="Transit Name", description="The name of the Transit Name label in the chart, in the language")
+    lunar_phase: str = Field(title="Lunar Phase", description="The name of the Lunar Phase label in the chart, in the language")
+    day: str = Field(title="Day", description="The name of the Day label in the chart, in the language")
+    celestial_points: KerykeionLanguageCelestialPointModel
+
+
+class KerykeionGeneralSettingsModel(CustomBaseModel):
+    axes_orbit: int = Field(title="Axes Orbit", description="The orbit of the axes in the chart")
+    planet_in_zodiac_extra_points: int = Field(title="Planet in Zodiac Extra Points", description="The extra points of the planet in the zodiac")
+    language: str = Field(title="Language", description="The language of the chart")
+
+class KerykeionChartSettingsModel(CustomBaseModel):
+    basic_chart_viewBox: str = Field(title="Basic Chart ViewBox", description="The viewbox of the basic chart")
+    wide_chart_viewBox: str = Field(title="Wide Chart ViewBox", description="The viewbox of the wide chart")
+
+# Settings Model
+class KerykeionSettingsModel(CustomBaseModel):
+    """
+    This class is used to define the global settings for the Kerykeion.
+    """
+
+    chart_colors: KerykeionSettingsChartColorsModel = Field(title="Chart Colors", description="The colors of the chart")
+    celestial_points: List[KerykeionSettingsCelestialPointModel] = Field(title="Celestial Points", description="The list of the celestial points of the chart")
+    aspects: List[KerykeionSettingsAspectModel] = Field(title="Aspects", description="The list of the aspects of the chart")
+    language_settings: dict[str, KerykeionLanguageModel] = Field(title="Language Settings", description="The language settings of the chart")
+    general_settings: KerykeionGeneralSettingsModel = Field(title="General Settings", description="The general settings of the chart")
+    chart_settings: KerykeionChartSettingsModel = Field(title="Chart Settings", description="The chart settings of the chart")