# Kerykeion > Open-source Python library for astrology, hosted REST API, and content hub with thousands of astrology and tarot guides. Kerykeion is a modern, type-safe Python library for astrological calculations: natal charts, synastry, transits, composite charts, planetary returns, and SVG chart rendering. Licensed under AGPLv3. - Homepage: https://kerykeion.net - Full site documentation (single file): https://kerykeion.net/llms-full.txt - Source code: https://github.com/g-battaglia/kerykeion - PyPI: https://pypi.org/project/kerykeion/ - About: https://kerykeion.net/about ## Kerykeion Python Library Documentation for the Kerykeion Python library (`pip install kerykeion`). - Library landing: https://kerykeion.net/python-library - Docs index: https://kerykeion.net/python-library/docs/v5 - Full docs (single file): https://kerykeion.net/python-library/docs/llms-full.txt - [Migration Guide v4 to v5](https://kerykeion.net/python-library/docs/v5/migration): Step-by-step instructions to migrate your code from Kerykeion v4 to v5 - [Troubleshooting & FAQ](https://kerykeion.net/python-library/docs/v5/faq): Common issues, error messages, and solutions for Kerykeion - [Glossary](https://kerykeion.net/python-library/docs/v5/glossary): Astrological terms and concepts explained for developers - [Complete Tutorial](https://kerykeion.net/python-library/docs/v5/tutorial): Build a complete astrology application from scratch with Kerykeion - [Astrological Subject Factory](https://kerykeion.net/python-library/docs/v5/astrological_subject_factory): Master the creation of astrological subjects in Kerykeion. Detailed guide on birth data, zodiac types, house systems, and coordinate perspectives. - [Chart Data Factory](https://kerykeion.net/python-library/docs/v5/chart_data_factory): Generate structured, machine-readable astrological data with the ChartDataFactory. Supports natal, synastry, transit, and composite charts. - [Charts Module - ChartDrawer](https://kerykeion.net/python-library/docs/v5/charts): A complete guide to Kerykeions visualization engine. Learn how to render professional SVG astrology charts, customize themes, and export to various formats. - [Report Module](https://kerykeion.net/python-library/docs/v5/report): Generate human-readable text reports and tables from your astrological data. Ideal for CLI applications, debugging, and consolidated chart summaries. - [Aspects Module](https://kerykeion.net/python-library/docs/v5/aspects): Learn how to calculate and analyze astrological aspects with Kerykeion. Covers major and minor aspects, orbs, and factory methods for chart analysis. - [Composite Subject Factory](https://kerykeion.net/python-library/docs/v5/composite_subject_factory): Understand the dynamics of relationships with composite charts. Learn how to calculate midpoints and generate unified relationship charts using Kerykeion. - [Relationship Score Factory](https://kerykeion.net/python-library/docs/v5/relationship_score_factory): Quantify relationship compatibility with the Relationship Score Factory. Implementation of the Ciro Discepolo method for numerical synastry analysis. - [House Comparison](https://kerykeion.net/python-library/docs/v5/house_comparison): Explore house overlays and synastry dynamics with the House Comparison Factory. Bidirectional analysis of where planets fall in a partner’s houses. - [Element & Quality Distribution](https://kerykeion.net/python-library/docs/v5/element_quality_distribution): Analyze the balance of elements and qualities in any chart. Explains weighted and pure count methods for calculating fire, earth, air, and water distribution. - [Planetary Return Factory](https://kerykeion.net/python-library/docs/v5/planetary_return_factory): Precisely calculate solar, lunar, and planetary returns with Kerykeion. High-precision timing for forecasting yearly and monthly astrological cycles. - [Moon Phase Details Factory](https://kerykeion.net/python-library/docs/v5/moon_phase_details_factory): Generate rich lunar phase context including illumination, upcoming phases, eclipses, sunrise/sunset, and solar position from any astrological subject. - [Transits Time Range Factory](https://kerykeion.net/python-library/docs/v5/transits_time_range_factory): Forecast upcoming astrological influences with transits. Learn how to calculate planetary movements over time against a fixed natal chart. - [Ephemeris Data Factory](https://kerykeion.net/python-library/docs/v5/ephemeris_data_factory): Generate time-series astrological data with the Ephemeris Data Factory. Perfect for creating planetary positions for any date range and interval. - [AI Context Serializer](https://kerykeion.net/python-library/docs/v5/context_serializer): Optimize your astrological data for Large Language Models. Learn how to use the AI Context Serializer to convert charts into precise, well-formed XML. - [Astrologer API](https://kerykeion.net/python-library/docs/v5/astrologer-api): Production-ready REST API for astrological calculations, SVG charts, and AI-powered interpretations. Skip the server setup and start building in minutes. - [Types & Schemas](https://kerykeion.net/python-library/docs/v5/schemas): Core data models, type definitions, and schemas - [Active Points Reference](https://kerykeion.net/python-library/docs/v5/active_points): Complete reference for all 63 celestial points available in Kerykeion: planets, asteroids, TNOs, Arabic parts, fixed stars, and special points. - [Cookbook](https://kerykeion.net/python-library/docs/v5/cookbook): Practical recipes and code snippets for common astrological tasks - [Utilities Module](https://kerykeion.net/python-library/docs/v5/utilities): Explore Kerykeions helper functions for coordinate conversions, house management, moon phases, and Julian date calculations. - [Settings](https://kerykeion.net/python-library/docs/v5/settings): Global configuration settings for Kerykeion - [Constants](https://kerykeion.net/python-library/docs/v5/constants): Exhaustive lists of available celestial points, aspects, and configuration constants. - [Chart Internals](https://kerykeion.net/python-library/docs/v5/chart_internals): Internal utilities for SVG rendering and coordinate conversion. - [Fetch Geonames](https://kerykeion.net/python-library/docs/v5/fetch_geonames): Utility to fetch location and timezone data from GeoNames API - [Legacy API](https://kerykeion.net/python-library/docs/v5/legacy): Documentation for deprecated classes and backward compatibility layers. ## Astrologer API REST API for astrological calculations, SVG chart rendering, and AI-powered interpretations. - Landing page: https://kerykeion.net/astrologer-api - API docs (index): https://kerykeion.net/astrologer-api/llms.txt - Full API docs (single file): https://kerykeion.net/astrologer-api/llms-full.txt ## LibEphemeris High-performance ephemeris engine for astrological calculations. - Docs: https://kerykeion.net/libephemeris ## Learn Astrology 12,059+ articles covering birth charts, transits, synastry, planetary returns, and more. - Section index: https://kerykeion.net/content/learn-astrology - Article listing: https://kerykeion.net/content/learn-astrology/llms.txt ## Learn Tarots 503 tarot card guides covering major and minor arcana, spreads, and reading techniques. - Section index: https://kerykeion.net/content/learn-tarots - Article listing: https://kerykeion.net/content/learn-tarots/llms.txt - Full content (single file): https://kerykeion.net/content/learn-tarots/llms-full.txt