Comment la plateforme fonctionne

Astrokai s'appuie sur Swiss Ephemeris, en mode Moshier, comme moteur principal de calcul. Swiss Ephemeris est la bibliothèque de référence du milieu astrologique professionnel ; son mode Moshier est une approximation semi-analytique de haute précisionde l'éphéméride du Jet Propulsion Laboratory de la NASA, qui ne nécessite aucun fichier de données externe. La précision sur les positions planétaires est de l'ordre de l'arcsecondesur toute la plage utile (de l'an −3000 à +3000).

En cas d'indisponibilité du binaire natif Swiss Ephemeris (build sans node-gyp, environnement contraint), Astrokai bascule automatiquement sur un moteur de secours maison. Celui-ci calcule le Soleil et la Lune par les séries de Jean Meeus (Astronomical Algorithms) et les planètes par éléments orbitaux képlériens. Sa précision est volontairement plus modeste — de l'ordre de l'arcminute sur le Soleil, du dixième de degré sur la Lune, jusqu'à quelques degrés sur les planètes lentes : suffisante pour garantir le bon signe et la bonne maison, mais non destinée à l'analyse fine. Le recours au moteur de secours est tracé côté serveur et consultable via le diagnostic d'administration.

La conversion entre heure locale de naissance et instant UTC absolu passe par Luxoncouplé à la base IANA tzdata. Cela garantit une gestion correcte des changements d'heure d'été/hiver, des décalages historiques (ex : la Russie a changé plusieurs fois ses fuseaux au XX^e siècle), ainsi que des heures ambiguës ou inexistantes lors des transitions DST. Le terme correctif Delta T— différence entre temps universel et temps terrestre — est appliqué automatiquement par le moteur Swiss Ephemeris (de l'ordre de 70 secondes en 2026).

Les conventions ci-dessous sont celles de l'astrologie occidentale moderne. Elles peuvent être modifiées dans l'interface lors du calcul d'un thème, sauf mention contraire.

• Zodiaque— tropical (aligné sur le point vernal et les saisons). Convention occidentale dominante. Les zodiaques sidéraux ne sont pas exposés dans l'UI actuelle.
• Système de maisons— Placidus par défaut. Alternatives proposées : Koch (système horaire répandu en astrologie moderne, notamment germanophone) et Whole Sign Houses (système ancien, plus stable aux hautes latitudes).
• Corps célestes inclus— Soleil, Lune, Mercure, Vénus, Mars, Jupiter, Saturne, Uranus, Neptune, Pluton, ainsi que le Nœud Nord lunaire moyen et la Lilith moyenne(Lune noire). Chiron, qui exige des fichiers d'éphémérides supplémentaires, figure dans la feuille de route.
• Points angulaires— ascendant, milieu du ciel et Vertex calculés et exposés. Descendant et fond du ciel déduits par symétrie (180° opposés).

L'orbe est l'écart toléré autour de l'angle exact d'un aspect pour qu'il soit considéré comme actif. Plus l'orbe est large, plus l'aspect a de chances d'exister, mais plus son influence est diffuse.

Ces valeurs sont les orbes par défaut du thème natal. Les aspects impliquant un luminaire(Soleil ou Lune) bénéficient d'un élargissement de +2°, ces deux corps étant les plus structurants du thème. Les transits utilisent des orbes plus serrés(sextile 5°, trigone 7°…) : un transit est un événement daté, et un orbe large l'étalerait sur plusieurs semaines. Ces conventions suivent les usages dominants de l'astrologie occidentale moderne — il n'existe pas de norme universelle des orbes.

Calculés et exposésdans les thèmes natals : les douze cuspides de maisons, l'ascendant, le milieu du ciel et le Vertex, les positions des corps célestes listés plus haut, les aspects entre planètes, les rétrogradations, la phase lunaire de naissance, la Part de Fortune, les antiscia et contre-antiscia, et le nombre de chemin de vie (numérologie pythagoricienne). La fiche technique du thème (datasheet) rassemble l'ensemble de ces éléments.

Non implémentés à ce jour : dignités planétaires (domicile, exaltation, exil, chute), aspects mineurs (semi-carré, semi-sextile, sesquicarré, quintile), points arabes au-delà de la Part de Fortune, harmoniques au-delà du 8^e. Ces éléments figurent dans la feuille de route, sans engagement de date.

Kairos est le service interne qui produit les interprétations textuelles de Astrokai. Son pipeline est déterministe en entrée (les positions astrologiques exactes) et génératif en sortie (un modèle de langage rédige le texte). Voici les étapes :

1. Le moteur d'éphémérides calcule les positions, maisons et aspects du thème, puis enrichit le résultat avec des métadonnées (offset UTC appliqué, résolution timezone, indicateur d'heure connue ou inconnue).
2. Un prompt structuré est composé à partir de ces données. Il contient les positions exactes, les aspects majeurs, la phase lunaire, et des consignes éditoriales (ton, longueur, registres à éviter).
3. Le modèle de langage utilisé est xAI Grok (modèle grok-4.3 à ce jour). Il rédige une réponse en français en suivant le cadrage du prompt.
4. Un post-traitement applique des règles de cohérence (formatage Markdown, suppression d'artefacts), puis la réponse est mise en cache pour éviter de re-générer le même thème à chaque consultation.

Le contenu exact des prompts n'est pas public, mais aucune information personnelleau-delà des données astrologiques anonymisées (date, heure, lieu, positions calculées) n'est transmise au modèle. Le LLM ne connaît ni votre nom, ni votre email, ni l'historique de vos précédentes lectures.

Limites assumées : comme tout système génératif, Kairos peut produire des phrases imprécises sur les configurations rares (voir la page Limites). Les calculs eux-mêmes restent exacts : la fiche technique du thème permet toujours de vérifier indépendamment.

Astrokai est en évolution continue. Chaque mise à jour est testée, rejouable, et peut être annulée intégralement en cas de problème détecté en production. L'objectif : améliorer la plateforme sans jamais casser ce qui marchait pour toi.

Les changements de fond — ceux qui touchent aux conventions astrologiques, aux algorithmes de calcul ou au ton des lectures — font l'objet d'une note dans cette section, rétroactivement si nécessaire. Tu sauras pourquoi une lecture change si elle change.

Les évolutions purement techniques (sécurité, performance, compatibilité navigateur) restent silencieuses : elles n'affectent pas le contenu de ce que tu lis.

Astrokai s'appuie sur le corpus consolidé de l'astrologie occidentale du XX^e et XXI^esiècle. Pour les lectrices et lecteurs souhaitant approfondir, voici quelques points d'entrée fiables :

• Robert Hand, Horoscope Symbols (1981) — référence sur les significations symboliques des planètes et aspects.
• Liz Greene, Saturn: A New Look at an Old Devil(1976) — ouvrage fondateur de l'approche psychologique en astrologie.
• Stephen Arroyo, Astrology, Psychology, and the Four Elements(1975) — cadre élémentaire (feu, terre, air, eau) appliqué à l'astrologie.
• Howard Sasportas, The Twelve Houses(1985) — lecture détaillée du symbolisme des maisons astrologiques.
• Reinhold Ebertin, The Combination of Stellar Influences(1940) — ouvrage technique de référence sur les configurations à trois planètes.

Une bibliographie complète, avec attribution des sources par catégorie, est disponible sur la page Bibliographie.

Pourquoi la tradition occidentale ? Parce que c'est celle qui structure 90% des sources francophones disponibles, et parce qu'on préfère faire un seul système très bien que cinq systèmes superficiels.

Pourquoi les maisons Placidus ? C'est le standard moderne, le plus utilisé en astrologie psychologique. D'autres systèmes (Equal, Whole-Sign) pourront être ajoutés si la demande le justifie.

Pourquoi une IA plutôt qu'un astrologue humain ? Parce qu'on veut un outil disponible à 8h du matin, pas dans deux semaines. Et parce qu'on a calibré le ton de Kairos pour qu'il soit clair, sans jargon technique gratuit ni catastrophisme. C'est expérimental — l'IA peut se tromper, simplifier, manquer de nuance. On l'améliore en continu.