REPOGEO REPORT · LITE
g-battaglia/kerykeion
Default branch main · commit 8d4a5793 · scanned 6/2/2026, 4:41:50 AM
GitHub: 646 stars · 184 forks
Action plan is what to do next — copy-pasteable changes prioritized by impact. Category visibility is the real GEO test: when a user asks an AI a brand-free question that should surface g-battaglia/kerykeion, does the AI actually recommend you — or your competitors? Objective checks verify the metadata signals AI engines weight first. Self-mention check detects whether AI even knows you exist by name.
Action plan — copy-paste fixes
3 prioritized changes generated by gemini-2.5-flash. Mark items done after you ship the fix.
- highreadme#1Strengthen README's opening paragraph to highlight unique positioning
Why:
CURRENTKerykeion is a Python library for astrology. It computes planetary and house positions, detects aspects, and generates SVG charts, including birth, synastry, transit, and composite charts. You can also customize which planets to include in your calculations. The main goal of this project is to provide high-precision astrological calculations through a clean, data-driven approach, making them accessible and programmable.
COPY-PASTE FIXKerykeion is a high-level Python library for **data-driven astrology**, providing a clean, programmable interface for complex astrological calculations. Unlike lower-level astronomical engines, Kerykeion focuses on delivering an opinionated, astrology-specific API to compute planetary and house positions, detect aspects, and generate SVG charts for birth, synastry, transit, and composite charts with high precision.
- mediumreadme#2Add a comparison section to the README
Why:
COPY-PASTE FIXAdd a new section to the README, for example, after 'Basic Usage' or 'Main Goal': ## Why Kerykeion? (vs. PyEphem, AstroPy, and pyswisseph) While libraries like PyEphem, AstroPy, and pyswisseph provide powerful astronomical calculations, Kerykeion differentiates itself by offering a **high-level, astrology-focused API**. It abstracts away the complexities of raw astronomical data, providing an opinionated and Pythonic interface specifically designed for astrological concepts like aspects, house systems, and chart generation. Kerykeion is built for astrologers and developers who need ready-to-use astrological insights and visualizations, rather than just raw celestial mechanics.
- lowtopics#3Add 'python-library' and 'astrology-library' to topics
Why:
CURRENTastrologer, astrology, astrology-calculator, astronomical-algorithms, birthchart, charts, composite-chart, data-driven, data-science, ephemeris, planets, python, svg, synastry, tranist-chart, transits, zodiac-algorithm, zodiac-sign, zodiacsign-calculator
COPY-PASTE FIXastrologer, astrology, astrology-calculator, astrology-library, astronomical-algorithms, birthchart, charts, composite-chart, data-driven, data-science, ephemeris, planets, python, python-library, svg, synastry, tranist-chart, transits, zodiac-algorithm, zodiac-sign, zodiacsign-calculator
Category GEO backends resolved for this scan: google/gemini-2.5-flash, deepseek/deepseek-v4-flash
Category visibility — the real GEO test
Brand-free queries asked to google/gemini-2.5-flash. Did AI recommend you, or someone else?
Same questions for every model — switch tabs to compare answers and rankings.
- PyEphem · recommended 2×
- AstroPy · recommended 2×
- swephR · recommended 1×
- python-astrology · recommended 1×
- pyswisseph · recommended 1×
- CATEGORY QUERYHow can I generate astrological birth charts and synastry reports using a Python library?you: not recommendedAI recommended (in order):
- swephR
- PyEphem
- AstroPy
- python-astrology
- pyswisseph
AI recommended 5 alternatives but never named g-battaglia/kerykeion. This is the gap to close.
Show full AI answer
- CATEGORY QUERYWhat Python tools are available for precise planetary position calculations and SVG chart rendering?you: not recommendedAI recommended (in order):
- AstroPy
- CairoSVG
- svgwrite
- Skyfield
- PyEphem
- Matplotlib
- Pillow
AI recommended 7 alternatives but never named g-battaglia/kerykeion. This is the gap to close.
Show full AI answer
Objective checks
Rule-based audits of metadata signals AI engines weight most.
- Metadata completenesspass
- README presencepass
Self-mention check
Does AI even know your repo exists when asked about it directly?
- Compared to common alternatives in this category, what is the core differentiator of g-battaglia/kerykeion?passAI named g-battaglia/kerykeion explicitly
AI answers can be confidently wrong. Read for accuracy: does it match your actual tech stack, audience, and differentiator?
- If a team adopts g-battaglia/kerykeion in production, what risks or prerequisites should they evaluate first?passAI named g-battaglia/kerykeion explicitly
AI answers can be confidently wrong. Read for accuracy: does it match your actual tech stack, audience, and differentiator?
- In one sentence, what problem does the repo g-battaglia/kerykeion solve, and who is the primary audience?passAI named g-battaglia/kerykeion explicitly
AI answers can be confidently wrong. Read for accuracy: does it match your actual tech stack, audience, and differentiator?
Embed your GEO score
Drop this badge into the README of g-battaglia/kerykeion. It auto-updates whenever the report is rescanned and links back to the latest report — easy public proof that you care about AI discoverability.
[](https://repogeo.com/en/r/g-battaglia/kerykeion)<a href="https://repogeo.com/en/r/g-battaglia/kerykeion"><img src="https://repogeo.com/badge/g-battaglia/kerykeion.svg" alt="RepoGEO" /></a>Subscribe to Pro for deep diagnoses
g-battaglia/kerykeion — Lite scans stay free; this card itemizes Pro deep limits vs Lite.
- Deep reports10 / month
- Brand-free category queries5 vs 2 in Lite
- Prioritized action items8 vs 3 in Lite