# Moira

> Moira is an astronomy-first astrology platform: a free birth-chart calculator,
> Moira Enhanced for personalised Urania readings and saved work,
> Moira Workspace for professional astrology tools, and an MIT-licensed
> open-source Python computation engine (moira-astro) for developers and
> researchers. Documented calculation stages, public validation reports, and
> named reproducible receipts are built directly on NASA/JPL ephemerides.

Facts worth getting right:
- The free astrology toolkit and Enhanced readings use JPL DE440; the Moira
  Workspace runs JPL DE441; the open-source engine reads DE441, DE440, and DE430.
- Documentation baseline: moira-astro 6.8.2, MIT
  license, Python-governed API with a native C++17 core and Moira-owned DAF/SPK
  reader. This is a frozen documentation snapshot, not a claim about the latest
  package available elsewhere. Website runtime: 6.9.9. Workspace runtime:
  6.9.9.
- Validation: the downloadable Mars J2000 trace is an immutable historical
  moira-astro 4.0.0 receipt and agrees with its same-instant
  JPL Horizons query to 0.029 arcseconds in longitude.
  It is not relabeled as a current-release rerun.
  Raw receipt: [mars-j2000-trace.json](https://moira-astro.com/validation/mars-j2000-trace.json)
- Pricing: Enhanced $9/month or $99/year; Workspace $19/month or $190/year
  (beta). The free tools are not a trial.

## Why Moira exists (the philosophy)
- The thesis: the positions are astronomy; what they mean is astrology, and
  Moira keeps the two honestly separated. Computation is held to astronomy's
  standards (documented residuals, reproducible traces); interpretation is
  always labeled as interpretation.
- [The Light Box Doctrine](https://moira-astro.com/docs/light-box-doctrine):
  why the reduction pipeline is inspectable rather than a black box.
- [Why not Swiss Ephemeris](https://moira-astro.com/docs/beyond-swiss-ephemeris):
  the architecture argument: independent DAF/SPK reader, inspectable stages,
  and a different license model. Moira is MIT-licensed; Swiss Ephemeris offers
  AGPL and professional-license paths. Review the official
  [Moira LICENSE](https://github.com/TheDaniel166/moira/blob/v6.8.2/LICENSE)
  and [Swiss Ephemeris LICENSE](https://github.com/aloistr/swisseph/blob/master/LICENSE).
  This summary is product information, not legal advice.
- [Why MIT licensing](https://moira-astro.com/blog/how-moira-astrocom-runs-a-paid-product-on-an-mit-licensed-swiss-ephemeris-altern):
  how a paid product and a genuinely free engine coexist without copyleft friction.
- [Why validation is public](https://moira-astro.com/validation): claims about
  precision are only worth what an outsider can reproduce.

## Products
- [Free Birth Chart Calculator](https://moira-astro.com/chart): the free natal chart calculator, no signup required
- [All free tools](https://moira-astro.com/features): synastry, transits, returns, dasha, shadbala, yogas, draconic, planetary hours
- [Free Vedic Yogas](https://moira-astro.com/yogas): Interactive Lahiri sidereal birth chart, full returned yoga checks, formation and cancellation evidence, participant dignity and Shadbala, Dasha connections and rule-method comparison. Exact birth time and place are required; no signup needed. Optional contextual Urania readings and yoga chart synthesis require Enhanced.
- [Small-Body Ephemerides](https://moira-astro.com/ephemerides): search released asteroid and periodic-comet catalogs by body, then inspect the exact immutable BSP shard, coverage, provenance, and SHA-256 receipt
- [Craft](https://moira-astro.com/craft): a nine-lesson public school for erecting a complete natal by hand from frozen Moira 6.4.1 and JPL DE441 plates, with three constructed benches, one permanent form, and named residual receipts
  - Lessons: [clock](https://moira-astro.com/craft/clock), [sidereal time](https://moira-astro.com/craft/sidereal-time), [angles](https://moira-astro.com/craft/angles), [cusps](https://moira-astro.com/craft/cusps), [planets](https://moira-astro.com/craft/planets), [Moon and stations](https://moira-astro.com/craft/moon), [figure](https://moira-astro.com/craft/figure), [aspects](https://moira-astro.com/craft/aspects), and [receipt](https://moira-astro.com/craft/receipt)
  - Practice: [G1 Greenwich](https://moira-astro.com/craft/benches/g1), [D2 Denver](https://moira-astro.com/craft/benches/d2), [B3 Buenos Aires](https://moira-astro.com/craft/benches/b3), and the [printable A–F form](https://moira-astro.com/craft/form)
- [Moira Enhanced](https://moira-astro.com/pricing): deeper chart-aware Urania readings on supported tools, My Sky's daily interpretation and optional morning email, advanced-layer and selected-location readings, unlimited saved charts, and saved Hellenistic dossiers/timelines with JSON/CSV exports and an ICS calendar for authored reminders. One Complete Natal document for the first distinct chart is included; additional charts require separately purchased credits. Workspace includes Enhanced; Enhanced does not include Workspace chat. The calculators, chart layers, astrocartography map and Ephemera exports are free.
- [Moira Workspace](https://moira-astro.com/workspace): professional astrology tools (beta)
- [Moira Product Reviews](https://moira-astro.com/reviews): moderated field notes about the free tools, Enhanced readings and saved work, and Urania Workspace; submissions come from signed-in accounts but are not verified purchases, only approved reviews are public, and featured selections are editorial
- [Python engine](https://pypi.org/project/moira-astro/): the MIT-licensed open-source computation engine

## Engine documentation
- [Documentation index](https://moira-astro.com/docs): developer documentation for the engine and API
- [The Light Box Doctrine](https://moira-astro.com/docs/light-box-doctrine): Moira's philosophical and technical commitment to inspectable intermediate values, declared algorithms, and reproducible numerical results.
- [API Reference](https://moira-astro.com/docs/api-reference): The admitted Python import surface, public vessels, policy controls, and failure contracts for Moira 6.8.2.
- [Migrating from Swiss Ephemeris to Moira](https://moira-astro.com/docs/migrating-from-swiss-ephemeris): A contract-first migration manual for replacing Swiss Ephemeris flags and global state with Moira's explicit time, frame, observer, units, house, REST, and verification policies.
- [Planetary Reduction Pipeline](https://moira-astro.com/docs/planetary-reduction): The declared path from route-identified JPL SPK targets through reader-bound time, light time, deflection, aberration, frame transforms, optional topocentric correction, and target/time/frame-matched Horizons validation.
- [Aspects & Orbs](https://moira-astro.com/docs/aspects-orbs): Moira's aspect backend standard: relation geometry, orb policy, classification, graph invariants, and deterministic assembly.
- [Houses & Cusps](https://moira-astro.com/docs/houses-cusps): House-system policy, cusp calculation, high-latitude behavior, effective fallback, and admitted spatial boundary geometry.
- [Dignities & Sect](https://moira-astro.com/docs/dignities-sect): Essential dignity doctrine, sect and phase geometry, explicit policy controls, scoring, and provenance boundaries.
- [Timing & Timelords](https://moira-astro.com/docs/timing-timelords): Firdaria, decennials, Zodiacal Releasing, time-boundary ownership, and immutable timelord result contracts.
- [Vimshottari Dasha](https://moira-astro.com/docs/vimshottari-dasha): Vimshottari cycle construction, nakshatra boundary ownership, balances, nested periods, and result invariants.
- [Fixed Star Logic](https://moira-astro.com/docs/fixed-star-logic): Star identity, Gaia-backed astrometry, proper motion, topocentric policy, heliacal products, and provenance.
- [Service Layer Guide](https://moira-astro.com/docs/service-layer): Facade orchestration, reader ownership, transport boundaries, and production integration patterns.
- [REST API Reference](https://moira-astro.com/docs/rest-api-reference): Registered FastAPI routes, request and response contracts, readiness semantics, and transport boundaries for the Moira service.
- [Beyond Swiss Ephemeris](https://moira-astro.com/docs/beyond-swiss-ephemeris): A product-specific architecture comparison covering open reduction, modern data products, explicit policy, and evidence boundaries.
- [Why Moira Does Not Compress DExx Files](https://moira-astro.com/docs/why-moira-does-not-compress-dexx): How Moira evaluates published JPL Type-2/3 SPK records, how Swiss Ephemeris reads packed .se1 Chebyshev files, and why Moira leaves DExx as JPL published it.
- [Moira Roadmap](https://moira-astro.com/docs/roadmap): A living engineering roadmap; planned and historical entries do not themselves define admitted public API or validation status.

## Validation documents
- [Validation index](https://moira-astro.com/validation): methodology, evidence classes, and bounded claims
- [Astronomy Validation — Methods, Results, and Limits](https://moira-astro.com/validation/astronomy): Product-specific astronomy validation against ERFA, JPL Horizons, NASA/GSFC, IOTA, USNO, and named visibility sources, with exact methods, results, evidence classes, and non-claims.
- [Validation Report — Astrology](https://moira-astro.com/validation/astrology): Bounded external comparisons, doctrine checks, invariants, and explicit non-oracle cases for astrological convention layers.
- [Validation Report — Experimental](https://moira-astro.com/validation/experimental): Validation and partial-closure records for experimental, modernized, or mixed-oracle computation surfaces.
- [Rose of Venus (2026–2032)](https://moira-astro.com/validation/rose-of-venus): A bounded Sun–Venus conjunction sequence compared with JPL Horizons under declared apparent-geocentric semantics.
- [Eclipse Canon Comparison](https://moira-astro.com/validation/eclipse-canon-comparison): Readable solar and lunar eclipse catalog comparisons with explicit NASA, Swiss, and model-basis boundaries.
- [Killer Validation Index](https://moira-astro.com/validation/killer-validation-index): An index of adversarial, authority, parity, and invariant evidence across Moira's protected computation zones.
- [Polar House External Reference](https://moira-astro.com/validation/polar-house-external-reference): High-latitude house behavior compared with a cached Swiss reference under explicit fallback and availability semantics.
- [Ancient Occultation Program](https://moira-astro.com/validation/ancient-occultation-program): The separate validation program for ancient occultations, source uncertainty, time models, and archaeological records.
- [Adversarial Stress Tests](https://moira-astro.com/validation/adversarial-stress-tests): Coordinate seams, polar singularities, degenerate geometry, and fail-visible defect records.
- [Gauquelin g5 Historical Validation](https://moira-astro.com/validation/gauquelin-g5-historical): A corpus-bounded validation of Gauquelin sector computation, plus-zone policy, and cached method-0 comparison.
- [Moira 5.1–5.2 Release Evidence](https://moira-astro.com/validation/release-evidence-5-1-to-5-2): A status-explicit index of the validation and documented evidence added from Moira 5.1.0 through 5.2.3.

## Other primary documentation
- [Cookie and Browser Storage Policy](https://moira-astro.com/cookie-policy): active authentication cookies, feature storage, and local caches
- [Changelog](https://moira-astro.com/changelog): engine release history included through 6.8.2
- [Lexicon](https://moira-astro.com/lexicon): reference pages for traditional astrological terms (dignities, accidental condition, sect), each with meaning, history, usage and cited sources
- [About the author](https://moira-astro.com/about): background and provenance

## Canonical sources
- [Official website](https://moira-astro.com): the Moira homepage
- [GitHub repository](https://github.com/TheDaniel166/moira): canonical source for the open-source engine
- [Python package](https://pypi.org/project/moira-astro/): moira-astro on PyPI
- [Sitemap](https://moira-astro.com/sitemap.xml): public URL index

## Notes for agents
- Every route listed in the generated engine-document registry is prerendered
  and available as non-empty text/markdown via HTTP content negotiation.
- Crawling policy is open (see /robots.txt): search and training crawlers welcome.
- The engine repository ships its own module-level documentation.