Documentation
Clean-room TypeScript astrology computation: ephemeris, charts, events, timing techniques, Vedic methods, and MCP tools, validated against named references.
New here? Start with the Quickstart, then read Computing Charts. The full package surface is in the API Reference.
Getting started
Install caelus and compute your first chart in the browser or Node.
Computing ChartsThe chart object: bodies, angles, cusps, aspects, and the UT vs local-time hazard.
Common TasksCopy-paste recipes: house placement, dignities, stations, ingresses, lunar phases, and a local birth time done right.
Guides
How the four packages compose end to end: birth time, engine, wheel, and MCP.
Houses & ZodiacsTwelve house systems, tropical and sidereal modes, and polar fallbacks.
Derived ChartsReturns, progressions, solar arc, composite, Davison, harmonics, dignities, and sect.
Hellenistic Time-LordsLots, profections, firdaria, zodiacal releasing, and primary directions.
Vedic & JyotishNakshatras, the Vimshottari/Yogini/Ashtottari dashas, the vargas, and the yogas.
Data TiersEmbedded vs Node loader: what ships in the bundle and what loads lazily.
RecipesTransits, the when() query language, event search, and chart wheels.
Electional SearchScan a window with rankMoments, score each instant with the electional primitives, and render the winning chart.
VisualizationsBeyond the flat wheel: a 3D chart sphere, an astrocartography world map, a graphic ephemeris, and Sky View frames for AI image prompts, rendered live.
Interpretation LayerProject validated charts into citable fact atoms: natal, transits, time-lords, synastry/composite, dignities, Vedic structure. Match, interpret, and audit LLM citations.
Building a CorpusConsume and construct interpretation corpora: PassageRecords, extractors, validation, and the public-domain delineations package.
Chart ProvenanceDeclare what a chart is and how time and place are known: realms, anchors, routing to ephemeris or compiler, and honest interpretation framing.
Synthetic EphemerisImaginary bodies that move: periodic and Kepler tiers, Engine registration, SkyView render attrs, and MCP tools for fictional skies.
Canonical ModeInteger, hashable, precision-honest output: quantized grids, content-addressable digests, and remainder sets.