Skip to main content

Methodology

How CelestKin Computes Readings

Deterministic chart math. Pattern-matched interpretation. Editorial rules.

This page is about how the product works. Who makes it, and why, is on our About page.

1. Chart computation

The chart math behind every reading is produced by a server-side engine that wraps Swiss Ephemeris — the same planetary ephemeris used by most professional astrology software. From a birth date, birth time, and a geocoded latitude/longitude, the engine derives planetary positions, houses, aspects, Nakshatra boundaries, Dasha start dates, and the tradition-specific quantities each system needs. The output is deterministic: the same inputs produce the same numbers every time.

The engine covers nine traditions: Vedic (sidereal, Lahiri ayanamsa, with Ashtakavarga, Shadbala, and Vimshottari Dashas), KP (sub-lord theory with cuspal interlinks), Laal Kitab (the Punjabi-Vedic Khaana framework), Chinese (BaZi Four Pillars with solar-term-anchored year/month boundaries plus the Zi Wei Dou Shu 紫微斗数 constellation framework), Mayan (Dreamspell Tzolkin + Long Count + Yucatec classical Haab), Western (Hellenistic Sect, seven Lots, essential dignities, ten-aspect set with applying/separating, and Zodiacal Releasing from Spirit and Fortune), Pythagorean numerology, Human Design (derived from astronomical gate positions with 88° Design Sun), and biorhythm (the physical, emotional and intellectual cycles, shown with a note that the theory is folklore rather than science). Each system ships its own reference guides — the canonical texts our prompts draw from. Separately, body-scan tools (palm, thumb, nail, forehead, foot) run on uploaded images as a distinct surface from the chart traditions.

2. How a reading is written

Once the chart is computed, its numbers and the reference guides for the traditions involved are put together into one structured request to a language model, run on Amazon Web Services, which writes the reading. Which model answers depends on the kind of reading, its language, your plan and our current settings. The model is told to treat the chart as a map rather than a verdict, and to tie what it says to this person's own chart instead of writing a generic horoscope. What the model is sent, what it keeps, and what it can get wrong are set out on the page that explains how readings are made.

3. Editorial rules (the ten language laws)

The instructions sent with our chart readings, whichever model writes them, and with our compatibility, dream, and palm and body readings, include ten editorial rules we call the language laws. In short: the chart is a map rather than a verdict, and the reader, not a planet, is the one acting in every sentence; "you can" is the main verb, and "you will" is allowed only with a specific date window; a difficult period is described as temporary, limited to one area of life, and caused by a transit or period rather than by the reader's character; placements are described as teachers or allies, never as afflictions; every claim is tied to this person's own chart and said in plain words; each reading ends with one action that takes about ten minutes this week; it speaks to who the reader is rather than promising outcomes; a named challenge comes with an argument against its worst reading and the strength that period brings; invitations to come back rely on curiosity, never guilt; and a list of fatalistic phrases is banned outright. The laws are not part of the instructions for the chat, the cards on the Your Nature page, the short explanations on each tradition's tab, the baby-name generator, the aura and Feng Shui tools, or the daily and weekly digests.

A separate instruction that sets the voice of our readings tells the model to answer questions about marriage, partners, timing and children directly rather than refusing or deflecting them, and to soften the framing, not the substance. The readings that carry the language laws also carry a rule against medical language: no assessment of the body, and health questions are pointed to a licensed healthcare professional. When a reading breaks these rules, we treat it as a bug and change the instructions the model is given.

4. What CelestKin does not do

  • Guarantee outcomes. A reading may name a time window, and it answers questions about marriage and timing directly when you ask. That is a reading of your chart by a tradition's rules, not a promise that anything will happen.
  • Diagnose. We do not produce medical, psychological, legal, or financial diagnoses. We are not a substitute for a clinician, a lawyer, or a financial advisor.
  • Make decisions for you. Readings surface patterns and prompts. The decision stays with you.
  • Claim validation. Astrology has no proven predictive power in the scientific sense. We use it as a structured journaling and reflection surface, and we say so.

5. Reflection-first design

The whole stack is tuned around a single question: does this reading help the user reflect, or does it push them to outsource? Fatalistic phrases, sweeping claims about what a person is always like, and orders such as "you must" all fail that test. If you ever catch us breaking the rule, write in via the contact page.