Metadata-Version: 2.4
Name: libephemeris
Version: 4.0.0
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Rust
Classifier: Topic :: Scientific/Engineering :: Astronomy
Classifier: Typing :: Typed
Requires-Dist: numpy>=1.26
License-File: COPYING
License-File: THIRD_PARTY_NOTICES.md
License-File: core/licenses/adler2-2.0.1/LICENSE-0BSD
License-File: core/licenses/adler2-2.0.1/LICENSE-APACHE
License-File: core/licenses/adler2-2.0.1/LICENSE-MIT
License-File: core/licenses/android_system_properties-0.1.6/LICENSE-APACHE
License-File: core/licenses/android_system_properties-0.1.6/LICENSE-MIT
License-File: core/licenses/arc-swap-1.9.3/LICENSE-APACHE
License-File: core/licenses/arc-swap-1.9.3/LICENSE-MIT
License-File: core/licenses/autocfg-1.5.1/LICENSE-APACHE
License-File: core/licenses/autocfg-1.5.1/LICENSE-MIT
License-File: core/licenses/base64-0.23.1/LICENSE-APACHE
License-File: core/licenses/base64-0.23.1/LICENSE-MIT
License-File: core/licenses/bitflags-2.13.2/LICENSE-APACHE
License-File: core/licenses/bitflags-2.13.2/LICENSE-MIT
License-File: core/licenses/block-buffer-0.10.4/LICENSE-APACHE
License-File: core/licenses/block-buffer-0.10.4/LICENSE-MIT
License-File: core/licenses/block-buffer-0.12.1/LICENSE-APACHE
License-File: core/licenses/block-buffer-0.12.1/LICENSE-MIT
License-File: core/licenses/bumpalo-3.20.3/LICENSE-APACHE
License-File: core/licenses/bumpalo-3.20.3/LICENSE-MIT
License-File: core/licenses/bytemuck-1.25.2/LICENSE-APACHE
License-File: core/licenses/bytemuck-1.25.2/LICENSE-MIT
License-File: core/licenses/bytemuck-1.25.2/LICENSE-ZLIB
License-File: core/licenses/bytes-1.12.1/LICENSE
License-File: core/licenses/cc-1.4.7/LICENSE-APACHE
License-File: core/licenses/cc-1.4.7/LICENSE-MIT
License-File: core/licenses/cfg-if-1.0.5/LICENSE-APACHE
License-File: core/licenses/cfg-if-1.0.5/LICENSE-MIT
License-File: core/licenses/chrono-0.4.42/LICENSE.txt
License-File: core/licenses/const-oid-0.10.2/LICENSE-APACHE
License-File: core/licenses/const-oid-0.10.2/LICENSE-MIT
License-File: core/licenses/core-foundation-sys-0.8.7/LICENSE-APACHE
License-File: core/licenses/core-foundation-sys-0.8.7/LICENSE-MIT
License-File: core/licenses/cpufeatures-0.3.1/LICENSE-APACHE
License-File: core/licenses/cpufeatures-0.3.1/LICENSE-MIT
License-File: core/licenses/crc32fast-1.5.2/LICENSE-APACHE
License-File: core/licenses/crc32fast-1.5.2/LICENSE-MIT
License-File: core/licenses/crypto-common-0.1.7/LICENSE-APACHE
License-File: core/licenses/crypto-common-0.1.7/LICENSE-MIT
License-File: core/licenses/crypto-common-0.2.2/LICENSE-APACHE
License-File: core/licenses/crypto-common-0.2.2/LICENSE-MIT
License-File: core/licenses/digest-0.10.7/LICENSE-APACHE
License-File: core/licenses/digest-0.10.7/LICENSE-MIT
License-File: core/licenses/digest-0.11.3/LICENSE-APACHE
License-File: core/licenses/digest-0.11.3/LICENSE-MIT
License-File: core/licenses/equivalent-1.0.3/LICENSE-APACHE
License-File: core/licenses/equivalent-1.0.3/LICENSE-MIT
License-File: core/licenses/errno-0.3.14/LICENSE-APACHE
License-File: core/licenses/errno-0.3.14/LICENSE-MIT
License-File: core/licenses/find-msvc-tools-0.1.13/LICENSE-APACHE
License-File: core/licenses/find-msvc-tools-0.1.13/LICENSE-MIT
License-File: core/licenses/flate2-1.1.10/LICENSE-APACHE
License-File: core/licenses/flate2-1.1.10/LICENSE-MIT
License-File: core/licenses/futures-core-0.3.34/LICENSE-APACHE
License-File: core/licenses/futures-core-0.3.34/LICENSE-MIT
License-File: core/licenses/futures-task-0.3.34/LICENSE-APACHE
License-File: core/licenses/futures-task-0.3.34/LICENSE-MIT
License-File: core/licenses/futures-util-0.3.34/LICENSE-APACHE
License-File: core/licenses/futures-util-0.3.34/LICENSE-MIT
License-File: core/licenses/generic-array-0.14.7/LICENSE
License-File: core/licenses/getrandom-0.2.17/LICENSE-APACHE
License-File: core/licenses/getrandom-0.2.17/LICENSE-MIT
License-File: core/licenses/getrandom-0.4.3/LICENSE-APACHE
License-File: core/licenses/getrandom-0.4.3/LICENSE-MIT
License-File: core/licenses/hashbrown-0.17.1/LICENSE-APACHE
License-File: core/licenses/hashbrown-0.17.1/LICENSE-MIT
License-File: core/licenses/heck-0.5.0/LICENSE-APACHE
License-File: core/licenses/heck-0.5.0/LICENSE-MIT
License-File: core/licenses/http-1.5.0/LICENSE-APACHE
License-File: core/licenses/http-1.5.0/LICENSE-MIT
License-File: core/licenses/httparse-1.10.1/LICENSE-APACHE
License-File: core/licenses/httparse-1.10.1/LICENSE-MIT
License-File: core/licenses/hybrid-array-0.4.15/LICENSE-APACHE
License-File: core/licenses/hybrid-array-0.4.15/LICENSE-MIT
License-File: core/licenses/iana-time-zone-0.1.65/LICENSE-APACHE
License-File: core/licenses/iana-time-zone-0.1.65/LICENSE-MIT
License-File: core/licenses/iana-time-zone-haiku-0.1.2/LICENSE-APACHE
License-File: core/licenses/iana-time-zone-haiku-0.1.2/LICENSE-MIT
License-File: core/licenses/index.json
License-File: core/licenses/indexmap-2.14.2/LICENSE-APACHE
License-File: core/licenses/indexmap-2.14.2/LICENSE-MIT
License-File: core/licenses/itoa-1.0.18/LICENSE-APACHE
License-File: core/licenses/itoa-1.0.18/LICENSE-MIT
License-File: core/licenses/jobserver-0.1.35/LICENSE-APACHE
License-File: core/licenses/jobserver-0.1.35/LICENSE-MIT
License-File: core/licenses/js-sys-0.3.106/LICENSE-APACHE
License-File: core/licenses/js-sys-0.3.106/LICENSE-MIT
License-File: core/licenses/libc-0.2.189/LICENSE-APACHE
License-File: core/licenses/libc-0.2.189/LICENSE-MIT
License-File: core/licenses/linux-raw-sys-0.12.1/COPYRIGHT
License-File: core/licenses/linux-raw-sys-0.12.1/LICENSE-APACHE
License-File: core/licenses/linux-raw-sys-0.12.1/LICENSE-Apache-2.0_WITH_LLVM-exception
License-File: core/licenses/linux-raw-sys-0.12.1/LICENSE-MIT
License-File: core/licenses/log-0.4.34/LICENSE-APACHE
License-File: core/licenses/log-0.4.34/LICENSE-MIT
License-File: core/licenses/matrixmultiply-0.3.11/LICENSE-APACHE
License-File: core/licenses/matrixmultiply-0.3.11/LICENSE-MIT
License-File: core/licenses/md-5-0.10.6/LICENSE-APACHE
License-File: core/licenses/md-5-0.10.6/LICENSE-MIT
License-File: core/licenses/memchr-2.8.3/COPYING
License-File: core/licenses/memchr-2.8.3/LICENSE-MIT
License-File: core/licenses/memchr-2.8.3/UNLICENSE
License-File: core/licenses/memmap2-0.9.11/LICENSE-APACHE
License-File: core/licenses/memmap2-0.9.11/LICENSE-MIT
License-File: core/licenses/miniz_oxide-0.9.1/LICENSE
License-File: core/licenses/miniz_oxide-0.9.1/LICENSE-APACHE.md
License-File: core/licenses/miniz_oxide-0.9.1/LICENSE-MIT.md
License-File: core/licenses/miniz_oxide-0.9.1/LICENSE-ZLIB.md
License-File: core/licenses/ndarray-0.17.2/LICENSE-APACHE
License-File: core/licenses/ndarray-0.17.2/LICENSE-MIT
License-File: core/licenses/num-complex-0.4.6/LICENSE-APACHE
License-File: core/licenses/num-complex-0.4.6/LICENSE-MIT
License-File: core/licenses/num-integer-0.1.47/LICENSE-APACHE
License-File: core/licenses/num-integer-0.1.47/LICENSE-MIT
License-File: core/licenses/num-traits-0.2.19/LICENSE-APACHE
License-File: core/licenses/num-traits-0.2.19/LICENSE-MIT
License-File: core/licenses/numpy-0.29.0/LICENSE
License-File: core/licenses/once_cell-1.21.4/LICENSE-APACHE
License-File: core/licenses/once_cell-1.21.4/LICENSE-MIT
License-File: core/licenses/percent-encoding-2.3.2/LICENSE-APACHE
License-File: core/licenses/percent-encoding-2.3.2/LICENSE-MIT
License-File: core/licenses/pin-project-lite-0.2.17/LICENSE-APACHE
License-File: core/licenses/pin-project-lite-0.2.17/LICENSE-MIT
License-File: core/licenses/pkg-config-0.3.34/LICENSE-APACHE
License-File: core/licenses/pkg-config-0.3.34/LICENSE-MIT
License-File: core/licenses/portable-atomic-1.15.0/LICENSE-APACHE
License-File: core/licenses/portable-atomic-1.15.0/LICENSE-MIT
License-File: core/licenses/portable-atomic-util-0.2.8/LICENSE-APACHE
License-File: core/licenses/portable-atomic-util-0.2.8/LICENSE-MIT
License-File: core/licenses/proc-macro2-1.0.107/LICENSE-APACHE
License-File: core/licenses/proc-macro2-1.0.107/LICENSE-MIT
License-File: core/licenses/pyo3-0.29.3/LICENSE-APACHE
License-File: core/licenses/pyo3-0.29.3/LICENSE-MIT
License-File: core/licenses/pyo3-0.29.3/pyo3-runtime/LICENSE-APACHE
License-File: core/licenses/pyo3-0.29.3/pyo3-runtime/LICENSE-MIT
License-File: core/licenses/pyo3-build-config-0.29.3/LICENSE-APACHE
License-File: core/licenses/pyo3-build-config-0.29.3/LICENSE-MIT
License-File: core/licenses/pyo3-ffi-0.29.3/LICENSE-APACHE
License-File: core/licenses/pyo3-ffi-0.29.3/LICENSE-MIT
License-File: core/licenses/pyo3-log-0.13.4/LICENSE-APACHE
License-File: core/licenses/pyo3-log-0.13.4/LICENSE-MIT
License-File: core/licenses/pyo3-macros-0.29.3/LICENSE-APACHE
License-File: core/licenses/pyo3-macros-0.29.3/LICENSE-MIT
License-File: core/licenses/pyo3-macros-backend-0.29.3/LICENSE-APACHE
License-File: core/licenses/pyo3-macros-backend-0.29.3/LICENSE-MIT
License-File: core/licenses/quote-1.0.47/LICENSE-APACHE
License-File: core/licenses/quote-1.0.47/LICENSE-MIT
License-File: core/licenses/r-efi-6.0.0/AUTHORS
License-File: core/licenses/rawpointer-0.2.1/LICENSE-APACHE
License-File: core/licenses/rawpointer-0.2.1/LICENSE-MIT
License-File: core/licenses/ring-0.17.14/LICENSE
License-File: core/licenses/ring-0.17.14/LICENSE-BoringSSL
License-File: core/licenses/ring-0.17.14/LICENSE-other-bits
License-File: core/licenses/ring-0.17.14/src/polyfill/once_cell/LICENSE-APACHE
License-File: core/licenses/ring-0.17.14/src/polyfill/once_cell/LICENSE-MIT
License-File: core/licenses/ring-0.17.14/third_party/fiat/LICENSE
License-File: core/licenses/rustc-hash-2.1.3/LICENSE-APACHE
License-File: core/licenses/rustc-hash-2.1.3/LICENSE-MIT
License-File: core/licenses/rustix-1.1.5/COPYRIGHT
License-File: core/licenses/rustix-1.1.5/LICENSE-APACHE
License-File: core/licenses/rustix-1.1.5/LICENSE-Apache-2.0_WITH_LLVM-exception
License-File: core/licenses/rustix-1.1.5/LICENSE-MIT
License-File: core/licenses/rustls-0.23.45/LICENSE-APACHE
License-File: core/licenses/rustls-0.23.45/LICENSE-ISC
License-File: core/licenses/rustls-0.23.45/LICENSE-MIT
License-File: core/licenses/rustls-pki-types-1.15.1/LICENSE-APACHE
License-File: core/licenses/rustls-pki-types-1.15.1/LICENSE-MIT
License-File: core/licenses/rustls-webpki-0.103.15/LICENSE
License-File: core/licenses/rustversion-1.0.23/LICENSE-APACHE
License-File: core/licenses/rustversion-1.0.23/LICENSE-MIT
License-File: core/licenses/safe_arch-0.7.4/LICENSE-APACHE.md
License-File: core/licenses/safe_arch-0.7.4/LICENSE-MIT.md
License-File: core/licenses/safe_arch-0.7.4/LICENSE-ZLIB.md
License-File: core/licenses/serde-1.0.229/LICENSE-APACHE
License-File: core/licenses/serde-1.0.229/LICENSE-MIT
License-File: core/licenses/serde_core-1.0.229/LICENSE-APACHE
License-File: core/licenses/serde_core-1.0.229/LICENSE-MIT
License-File: core/licenses/serde_derive-1.0.229/LICENSE-APACHE
License-File: core/licenses/serde_derive-1.0.229/LICENSE-MIT
License-File: core/licenses/serde_json-1.0.151/LICENSE-APACHE
License-File: core/licenses/serde_json-1.0.151/LICENSE-MIT
License-File: core/licenses/serde_spanned-1.1.2/LICENSE-APACHE
License-File: core/licenses/serde_spanned-1.1.2/LICENSE-MIT
License-File: core/licenses/sha2-0.11.0/LICENSE-APACHE
License-File: core/licenses/sha2-0.11.0/LICENSE-MIT
License-File: core/licenses/shlex-2.0.1/LICENSE-APACHE
License-File: core/licenses/shlex-2.0.1/LICENSE-MIT
License-File: core/licenses/simd-adler32-0.3.10/LICENSE.md
License-File: core/licenses/slab-0.4.12/LICENSE
License-File: core/licenses/subtle-2.6.1/LICENSE
License-File: core/licenses/syn-2.0.119/LICENSE-APACHE
License-File: core/licenses/syn-2.0.119/LICENSE-MIT
License-File: core/licenses/syn-3.0.6/LICENSE-APACHE
License-File: core/licenses/syn-3.0.6/LICENSE-MIT
License-File: core/licenses/target-lexicon-0.13.5/LICENSE
License-File: core/licenses/toml-0.9.12+spec-1.1.0/LICENSE-APACHE
License-File: core/licenses/toml-0.9.12+spec-1.1.0/LICENSE-MIT
License-File: core/licenses/toml_datetime-0.7.5+spec-1.1.0/LICENSE-APACHE
License-File: core/licenses/toml_datetime-0.7.5+spec-1.1.0/LICENSE-MIT
License-File: core/licenses/toml_parser-1.1.5+spec-1.1.0/LICENSE-APACHE
License-File: core/licenses/toml_parser-1.1.5+spec-1.1.0/LICENSE-MIT
License-File: core/licenses/toml_writer-1.1.3+spec-1.1.0/LICENSE-APACHE
License-File: core/licenses/toml_writer-1.1.3+spec-1.1.0/LICENSE-MIT
License-File: core/licenses/typenum-1.20.1/LICENSE
License-File: core/licenses/typenum-1.20.1/LICENSE-APACHE
License-File: core/licenses/typenum-1.20.1/LICENSE-MIT
License-File: core/licenses/unicode-ident-1.0.26/LICENSE-APACHE
License-File: core/licenses/unicode-ident-1.0.26/LICENSE-MIT
License-File: core/licenses/unicode-ident-1.0.26/LICENSE-UNICODE
License-File: core/licenses/untrusted-0.9.0/LICENSE.txt
License-File: core/licenses/ureq-3.4.2/LICENSE-APACHE
License-File: core/licenses/ureq-3.4.2/LICENSE-MIT
License-File: core/licenses/ureq-proto-0.6.4/LICENSE-APACHE.txt
License-File: core/licenses/ureq-proto-0.6.4/LICENSE-MIT.txt
License-File: core/licenses/utf8-zero-0.8.1/LICENSE-APACHE
License-File: core/licenses/utf8-zero-0.8.1/LICENSE-MIT
License-File: core/licenses/version_check-0.9.5/LICENSE-APACHE
License-File: core/licenses/version_check-0.9.5/LICENSE-MIT
License-File: core/licenses/wasi-0.11.1+wasi-snapshot-preview1/LICENSE-APACHE
License-File: core/licenses/wasi-0.11.1+wasi-snapshot-preview1/LICENSE-Apache-2.0_WITH_LLVM-exception
License-File: core/licenses/wasi-0.11.1+wasi-snapshot-preview1/LICENSE-MIT
License-File: core/licenses/wasm-bindgen-0.2.129/LICENSE-APACHE
License-File: core/licenses/wasm-bindgen-0.2.129/LICENSE-MIT
License-File: core/licenses/wasm-bindgen-macro-0.2.129/LICENSE-APACHE
License-File: core/licenses/wasm-bindgen-macro-0.2.129/LICENSE-MIT
License-File: core/licenses/wasm-bindgen-macro-support-0.2.129/LICENSE-APACHE
License-File: core/licenses/wasm-bindgen-macro-support-0.2.129/LICENSE-MIT
License-File: core/licenses/wasm-bindgen-shared-0.2.129/LICENSE-APACHE
License-File: core/licenses/wasm-bindgen-shared-0.2.129/LICENSE-MIT
License-File: core/licenses/webpki-roots-1.0.9/LICENSE
License-File: core/licenses/wide-0.7.33/LICENSE-ZLIB.md
License-File: core/licenses/windows-core-0.62.2/license-apache-2.0
License-File: core/licenses/windows-core-0.62.2/license-mit
License-File: core/licenses/windows-implement-0.60.2/license-apache-2.0
License-File: core/licenses/windows-implement-0.60.2/license-mit
License-File: core/licenses/windows-interface-0.59.3/license-apache-2.0
License-File: core/licenses/windows-interface-0.59.3/license-mit
License-File: core/licenses/windows-link-0.2.1/license-apache-2.0
License-File: core/licenses/windows-link-0.2.1/license-mit
License-File: core/licenses/windows-result-0.4.1/license-apache-2.0
License-File: core/licenses/windows-result-0.4.1/license-mit
License-File: core/licenses/windows-strings-0.5.1/license-apache-2.0
License-File: core/licenses/windows-strings-0.5.1/license-mit
License-File: core/licenses/windows-sys-0.52.0/license-apache-2.0
License-File: core/licenses/windows-sys-0.52.0/license-mit
License-File: core/licenses/windows-targets-0.52.6/license-apache-2.0
License-File: core/licenses/windows-targets-0.52.6/license-mit
License-File: core/licenses/windows_aarch64_gnullvm-0.52.6/license-apache-2.0
License-File: core/licenses/windows_aarch64_gnullvm-0.52.6/license-mit
License-File: core/licenses/windows_aarch64_msvc-0.52.6/license-apache-2.0
License-File: core/licenses/windows_aarch64_msvc-0.52.6/license-mit
License-File: core/licenses/windows_i686_gnu-0.52.6/license-apache-2.0
License-File: core/licenses/windows_i686_gnu-0.52.6/license-mit
License-File: core/licenses/windows_i686_gnullvm-0.52.6/license-apache-2.0
License-File: core/licenses/windows_i686_gnullvm-0.52.6/license-mit
License-File: core/licenses/windows_i686_msvc-0.52.6/license-apache-2.0
License-File: core/licenses/windows_i686_msvc-0.52.6/license-mit
License-File: core/licenses/windows_x86_64_gnu-0.52.6/license-apache-2.0
License-File: core/licenses/windows_x86_64_gnu-0.52.6/license-mit
License-File: core/licenses/windows_x86_64_gnullvm-0.52.6/license-apache-2.0
License-File: core/licenses/windows_x86_64_gnullvm-0.52.6/license-mit
License-File: core/licenses/windows_x86_64_msvc-0.52.6/license-apache-2.0
License-File: core/licenses/windows_x86_64_msvc-0.52.6/license-mit
License-File: core/licenses/winnow-0.7.15/LICENSE-MIT
License-File: core/licenses/winnow-1.0.4/LICENSE-MIT
License-File: core/licenses/zeroize-1.9.0/LICENSE-APACHE
License-File: core/licenses/zeroize-1.9.0/LICENSE-MIT
License-File: core/licenses/zlib-rs-0.6.8/LICENSE
License-File: core/licenses/zmij-1.0.23/LICENSE-MIT
License-File: core/licenses/zstd-0.14.0/LICENSE
License-File: core/licenses/zstd-safe-8.0.0/LICENSE
License-File: core/licenses/zstd-sys-2.1.0+zstd.1.5.7/LICENSE
License-File: core/licenses/zstd-sys-2.1.0+zstd.1.5.7/LICENSE.BSD-3-Clause
License-File: core/licenses/zstd-sys-2.1.0+zstd.1.5.7/zstd/COPYING
License-File: core/licenses/zstd-sys-2.1.0+zstd.1.5.7/zstd/LICENSE
Summary: Astrological ephemerides and astronomical calculations powered by Rust
Keywords: astrology,ephemeris,astronomy,jpl,astrometry,planetary
Author-email: Giacomo Battaglia <kerykeion.astrology@gmail.com>
License-Expression: AGPL-3.0
Requires-Python: >=3.12
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Homepage, https://github.com/g-battaglia/libephemeris
Project-URL: Repository, https://github.com/g-battaglia/libephemeris
Project-URL: Documentation, https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/docs/README.md
Project-URL: Issues, https://github.com/g-battaglia/libephemeris/issues
Project-URL: Changelog, https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/CHANGELOG.md

# LibEphemeris

**High-precision astrological ephemerides in Rust and Python, built on NASA/JPL data and published astronomical standards.**

**Version:** Python `4.0.0` · Rust core `1.0.0` · Python 3.12+ · [AGPL-3.0](https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/COPYING).

[Get started](https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/README.md#first-calculation) · [Scientific precision](https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/README.md#scientific-precision)
· [Italian manual](https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/beginners-manual/it/README.md)
· [English manual](https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/beginners-manual/en/README.md)
· [Documentation](https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/docs/README.md)
· [v4 release notes](https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/RELEASE_NOTES.md)

## Kerykeion ecosystem

LibEphemeris is the ephemeris engine in the
[**Kerykeion ecosystem**](https://github.com/g-battaglia/kerykeion).
Use LibEphemeris for low-level calculations, Kerykeion for chart data, aspects
and SVG rendering, or the hosted services below for ready-to-use applications.

## Astrologer API

For commercial closed-source projects, SaaS products and mobile apps,
[**Astrologer API**](https://www.kerykeion.net/content/astrologer-api/)
provides hosted astrology calculations and charts without a local installation.
Subscriptions support Kerykeion development.

[**Subscribe on RapidAPI**](https://rapidapi.com/gbattaglia/api/astrologer/pricing)
· [API documentation](https://www.kerykeion.net/content/astrologer-api/)
· [Coding-agent skill](https://github.com/g-battaglia/Astrologer-API/tree/v5/skills/astrologer-api)

## Built for astrology

| Area | Features |
| --- | --- |
| **Charts and transits** | Planetary positions, speeds, retrograde motion and angular separations |
| **Houses and angles** | Placidus, Whole Sign, Equal, Koch and other systems; Ascendant, Midheaven and house positions |
| **Sidereal astrology** | Lahiri, Fagan–Bradley and other ayanamshas, plus a user-defined mode |
| **Lunar points** | Mean/true nodes, mean/osculating apogee and interpolated apsides, with distinct definitions |
| **Events and returns** | Longitude crossings, stations, solar-return building blocks, eclipses and occultations |
| **Stars and minor bodies** | 1,447-star catalog; supported asteroids, centaurs and trans-Neptunian bodies with suitable data |
| **Local sky** | Topocentric positions, rise/set/transit, refraction, twilight and visibility models |

The [cookbook](https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/beginners-manual/en/15-cookbook.md) turns these primitives into
twelve practical recipes. Interpretation and aspect orbs remain application choices.

## Scientific precision

- **Ephemerides:** NASA/JPL DE440/DE441-family kernels and local LEB coefficient products.
- **Frames:** IAU/IERS conventions, SOFA/ERFA-derived components and Vondrák–Capitaine–Wallace long-term precession.
- **Clocks:** explicit UTC/UT1/TT handling, Stephenson–Morrison–Hohenkerk (2016) historical Delta-T reconstruction and supported IERS inputs.
- **Validation:** identified JPL data, published standards, high-precision mathematical constructions and physical invariants—not output matching as a scientific source.

The [source register](https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/docs/sources.md) documents provenance and separates published
models from project conventions. Source-incomplete hypothetical models fail
rather than return invented orbits.

**Numerical precision is not physical accuracy.** Source uncertainty, epoch,
frame, centre and observer all matter; historical Delta-T can dominate timing
uncertainty. The documented migration criteria include **0.001″ for angles** and
**1 second for events** under aligned inputs—not universal accuracy guarantees.
See [precision and limitations](https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/docs/limitations.md) for scope and qualifications.
Scientific accuracy concerns the calculated quantities, not astrological interpretation.

## Installation

After publication, install the native v4 release explicitly:

```sh
python -m pip install "libephemeris==4.0.0"
```

Before publication, [build a local wheel](https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/docs/installation.md#build-from-source).
Wheels include the Rust engine and modern base coefficients; NumPy is the Python
runtime dependency. Additional datasets are separate.

Rust applications use [`libephemeris-core`](https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/docs/rust.md) without Python;
`bundled-data` embeds the base image and `nbody` enables native integration.

## First calculation

Tropical positions and Placidus angles for Rome, **8 April 2024 at 12:00 UTC**,
plus a sidereal Moon position. Runs offline with the bundled data:

```python
import libephemeris as ephe

# Fix the data route and clock policy before calculating.
ephe.set_calc_mode("leb")
ephe.set_precision_tier("base")
ephe.set_network_policy("sealed")
ephe.set_iers_delta_t_enabled(False)
ephe.set_auto_spk_download(False)

# utc_to_jd returns TT first, UT1 second. calc_ut and houses need UT1.
jd_tt, jd_ut1 = ephe.utc_to_jd(2024, 4, 8, 12, 0, 0.0)
signs = (
    "Aries", "Taurus", "Gemini", "Cancer", "Leo", "Virgo",
    "Libra", "Scorpio", "Sagittarius", "Capricorn", "Aquarius", "Pisces",
)

positions = {}
for body, name in ((ephe.SUN, "Sun"), (ephe.MOON, "Moon"), (ephe.MERCURY, "Mercury")):
    values, returned_flags = ephe.calc_ut(jd_ut1, body, ephe.FLG_SPEED)
    positions[name] = values
    longitude, speed = values[0], values[3]
    sign = signs[int(longitude // 30)]
    motion = "retrograde" if speed < 0 else "direct"
    print(f"{name}: {longitude % 30:.4f}° {sign}, {speed:+.4f}°/day ({motion})")

# houses takes latitude, then east-positive longitude; cusps[0] is house one.
cusps, angles = ephe.houses(jd_ut1, 41.9028, 12.4964, b"P")
print(f"Ascendant: {angles[0]:.4f}°; Midheaven: {angles[1]:.4f}°")

# A separate context keeps the sidereal choice out of the tropical calculations.
sidereal = ephe.EphemerisContext()
sidereal.set_sid_mode(ephe.SIDM_LAHIRI)
moon_sidereal, _ = sidereal.calc_ut(jd_ut1, ephe.MOON, ephe.FLG_SIDEREAL)
print(f"Moon, Lahiri sidereal longitude: {moon_sidereal[0]:.4f}°")
```

Default positions are apparent and geocentric, in degrees and AU. `calc_ut`
accepts UT1; `calc` accepts TT. Convert local birth times to UTC first.
[Python conventions](https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/docs/python.md) covers units, flags and time-conversion domains.
Some house systems are undefined at polar latitudes.

For concurrency, use contexts for observer/sidereal state and configure shared
resources before starting workers. Native calls release the GIL but remain synchronous.

## Data and offline operation

| Mode | Route |
| --- | --- |
| `leb` | Local coefficients/models; no implicit JPL or Horizons substitution |
| `skyfield` | Native Rust JPL/SPK reader; historical name, no Python Skyfield backend |
| `auto` | Configured resources and provider routing |
| `horizons` | Explicit JPL Horizons network route |

`sealed` blocks calculation-time acquisition. Provision additional resources explicitly:

```sh
libephemeris init
libephemeris download auto
libephemeris status -vv
```

Nominal JPL tiers: **1850–2150** (`base`), **1550–2650** (`medium`),
**−13200–17191** (`extended`). Check actual per-file/body coverage, including the
surrounding interval needed for event searches. A wider tier is not an accuracy
guarantee. Record data versions and calculation settings for reproducibility.
[Data setup](https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/docs/data.md) · [CLI](https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/docs/cli.md).

## Documentation

- **Complete beginner manuals:** [Italiano](https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/beginners-manual/it/README.md) · [English](https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/beginners-manual/en/README.md)—fifteen chapters and twelve recipes each.
- **Reference:** [Python](https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/docs/python.md) · [Rust](https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/docs/rust.md) · [Generated API](https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/docs/api_reference.rst) · [Documentation index](https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/docs/README.md).
- **Migration:** [API compatibility and changed behavior](https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/MIGRATION.md). Familiar names and flags do not imply identical models or exception handling.
- **Development:** [Contributing](https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/CONTRIBUTING.md) · [Rust core](https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/core/README.md) · [Python bindings](https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/python/README.md) · [Changelog](https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/CHANGELOG.md).

## License

Code: [AGPL-3.0](https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/COPYING). Contributions: [CLA](https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/CLA.md).
External components retain their [own terms](https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/THIRD_PARTY_NOTICES.md);
manuals retain their [original licensing notice](https://github.com/g-battaglia/libephemeris/blob/python-v4.0.0/beginners-manual/README.md#provenance-and-license).

For inquiries about private licensing, contact Giacomo Battaglia at
[kerykeion.astrology@gmail.com](mailto:kerykeion.astrology@gmail.com).
Requests will be evaluated on a case-by-case basis.

Project home: [github.com/g-battaglia/libephemeris](https://github.com/g-battaglia/libephemeris).

## Astrologer Studio

Prefer a browser application? [**Astrologer Studio**](https://www.astrologerstudio.com/)
uses Kerykeion and Astrologer API for astrological calculations and charts—no
Python installation or ephemeris setup required.

[**Open Astrologer Studio**](https://www.astrologerstudio.com/)

