عن المشروع

Kerykeion مكتبة بايثون للحسابات الفلكية ورسم مخططات SVG. تحسب مواقع الكواكب والبيوت والزوايا والعودات والتقدّمات والتقنيات ذات الصلة، ثم تعرض النتائج كنماذج Pydantic يمكن فحصها في بايثون، أو تصديرها بصيغة JSON، أو تسلسلها بصيغة XML لسياق نماذج اللغة الكبيرة. تستخدم الإعدادات الافتراضية البروج الاستوائية وبيوت Placidus والمواقع الظاهرية المركزية الأرضية. تفصل المكتبة بين الحساب والعرض: يحسب AstrologicalSubjectFactory السماء والبيوت والنقاط والمصدر؛ ويضيف ChartDataFactory الزوايا والتوزيعات والزوايا الزاويّة والتجمّعات ودرجات العلاقات ومقارنات البيوت؛ ويعرض ChartDrawer البيانات المحسوبة مسبقًا بصيغة SVG. ينتج ReportGenerator نصًا، وينتج to_context صيغة XML، وينتج model_dump_json صيغة JSON. تشمل أنواع المخططات المدعومة مخططات الميلاد والأحداث، والتوافق، والعبور، والعودات الشمسية والقمرية، والعودات المركزية الشمسية، وعبور العقد القمرية، والمخطط المركّب بالنقطة الوسطى ومخططات Davison، والمخططات المُعاد تحديد موقعها، والتقدّمات الثانوية واتجاهات القوس الشمسي. تشمل الإعدادات البروج الاستوائية أو النجمية (47 نمطًا مسمّى بالإضافة إلى أيانامسا USER مخصّص)، وأنظمة البيوت، وبدائل البيوت القطبية، والمناظير الظاهرية/الحقيقية المركزية الأرضية، والطبوغرافية المركزية، والمركزية الشمسية، والمركزية الباريونية، والمركزية الكوكبية، ومجموعة نقاط نشطة قابلة للتهيئة تشمل العقد ومتغيّرات Lilith والأجزاء العربية والكويكبات والقناطير وأجرام ما وراء نبتون والنقاط الأورانية والنجوم الثابتة الاختيارية. تشمل ميزات التحليل الزوايا لمخطط واحد أو مخططين، وزوايا الميل، والحركة المتقدّمة/المنفصلة، والأورب المخصّص، ومقارنة البيوت، ودرجة علاقة Ciro Discepolo، وتوزيعات العناصر والصفات، والزوايا الزاويّة، والتجمّعات، والكرامات الأساسية. تأتي المخططات بأنماط Modern وClassic مع سمات كلاسيكية وداكنة وأبيض وأسود. يتطلب التثبيت Python 3.12 أو أحدث عبر pip. تستخدم طبقة التقويم الفلكي الافتراضية المراجَعة JPL DE440s التي تغطي 1850–2150، مع طبقات أوسع متاحة عبر libephemeris. تحتاج الحسابات دون اتصال إلى خط الطول وخط العرض ومنطقة زمنية IANA؛ ويمكن لوضع الاتصال تحديد المواقع عبر GeoNames. تتوفر أيضًا واجهة سطر أوامر ومهارة وكيل ذكاء اصطناعي. المشروع مرخّص بموجب AGPL-3.0، مع توفير API مستضاف للاستخدام التجاري مغلق المصدر.