v6.1.0 · API Reference

The Layered
Import Surface

Moira exposes four cumulative import layers from essentials through the complete facade, plus a focused parallel Vedic surface.

Quick Start

Get planetary positions in three lines of code.

Step 1 — Install
pip install moira-astro
Step 2 — Download Kernel
# GUI kernel manager
moira-kernel-manager

# Or CLI
moira-download-kernels --yes
Step 3 — First Chart
from moira.facade import Moira, HouseSystem
from datetime import datetime, timezone

m = Moira()  # auto-detects de440.bsp / de441.bsp / de430.bsp
dt = datetime(1988, 4, 4, 14, 30, tzinfo=timezone.utc)

chart = m.chart(dt)
for name, planet in chart.planets.items():
    print(f"{name:10s} {planet.longitude:.4f}°  speed {planet.speed:+.4f}°/day")

houses = m.houses(dt, latitude=51.5074, longitude=-0.1278, system=HouseSystem.PLACIDUS)
print(f"ASC {houses.asc:.3f}°  MC {houses.mc:.3f}°")

API Architecture

Four cumulative layers, plus a focused Vedic surface that builds directly on essentials.

moira.essentialsTier 1

Beginner surface for natal chart positions, house cusps, basic aspects, and sidereal conversions. Suitable for first-time users and lightweight integrations.

MoiraChartBodyHouseSystemPlanetDataAspectDatajulian_dayjd_from_datetime
moira.classicalTier 2

Adds the Western classical and traditional toolkit: dignities, Arabic Parts, fixed stars, time lords, and related chart techniques.

calculate_dignitiescalculate_lotsfirdariazodiacal_releasingvimshottaristar_atnavamsa
moira.predictiveTier 3

Adds the complete forecasting and relationship toolkit: transits, progressions, primary directions, synastry, eclipses, returns, stations, and void-of-course.

find_transitssecondary_progressionsolar_arcspeculumsynastry_aspectscomposite_chartdavison_chartEclipseCalculator
moira.vedicSpecialist

A focused parallel surface for Panchanga, sidereal and nakshatra work, vargas, Vedic dignities, dashas, Jaimini, Ashtakavarga, and Shadbala.

panchanga_atvimshottarinavamsajaimini_karakasashtakavargashadbala
moira.facadeComplete

Complete direct-import surface. Adds heliacal visibility, astrocartography, harmograms, occultations, variable stars, multiple-star systems, and the remaining admitted subsystems.

acg_linesharmogram_tracelunar_occultationvariable_starorbital_elements_atfamily_members

Code Examples

Real-world patterns for every major capability.

First Chart
from moira.facade import Moira, Body, HouseSystem
from datetime import datetime, timezone

m = Moira()  # auto-detects installed kernel
dt = datetime(1988, 4, 4, 14, 30, tzinfo=timezone.utc)

chart = m.chart(dt)
for name, planet in chart.planets.items():
    print(f"{name:10s} {planet.longitude:.4f}°  speed {planet.speed:+.4f}°/day")

Wiki Reference

Deep technical documentation for every subsystem.

The Light Box Doctrine
Moira's philosophical and technical commitment to inspectable intermediate values, declared algorithms, and reproducible numerical results.
API Reference
The admitted Python import surface, public vessels, policy controls, and failure contracts for Moira 6.1.0.
Planetary Reduction Pipeline
The declared path from JPL SPK state vectors through light time, deflection, aberration, frame transforms, and optional topocentric correction.
Aspects & Orbs
Moira's aspect backend standard: relation geometry, orb policy, classification, graph invariants, and deterministic assembly.
Houses & Cusps
House-system policy, cusp calculation, high-latitude behavior, effective fallback, and admitted spatial boundary geometry.
Dignities & Sect
Essential dignity doctrine, sect and phase geometry, explicit policy controls, scoring, and provenance boundaries.
Timing & Timelords
Firdaria, decennials, Zodiacal Releasing, time-boundary ownership, and immutable timelord result contracts.
Vimshottari Dasha
Vimshottari cycle construction, nakshatra boundary ownership, balances, nested periods, and result invariants.
Fixed Star Logic
Star identity, Gaia-backed astrometry, proper motion, topocentric policy, heliacal products, and provenance.
Service Layer Guide
Facade orchestration, reader ownership, transport boundaries, and production integration patterns.
REST API Reference
Registered FastAPI routes, request and response contracts, readiness semantics, and transport boundaries for the Moira service.
Beyond Swiss Ephemeris
A product-specific architecture comparison covering open reduction, modern data products, explicit policy, and evidence boundaries.
Moira Roadmap
A living engineering roadmap; planned and historical entries do not themselves define admitted public API or validation status.