PyMeeus
Python implementation of Jean Meeus astronomical routines
Decision gist · record as of 2026-08-14
Yes, if you need straightforward astronomical calculations for education, hobby projects, or applications where simplicity and minimal dependencies outweigh the need for cutting-edge precision or frequent updates. The library is stable, well-documented, and carries no known vulnerabilities. However, verify Python version compatibility first and consider whether other libraries better suit production-grade use cases. The long release gap since 2022-12-11 suggests infrequent maintenance.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- PyMeeus is a library of multiple modules, not a single module—you must import specific submodules (e.g., `from pymeeus.Epoch import Epoch`) rather than `import pymeeus` directly.
- Install friction is high—the package is distributed as a source tarball with no compiled dependencies, but has not been updated since 2022-12-11, despite the repository remaining active.
- Maintenance status is marked active, though the release gap suggests infrequent updates.
License · maintenance · safety
LGPLv3 (copyleft) — PyMeeus is licensed under LGPLv3 (copyleft). This means you may use, modify, and distribute it freely, but any derivative work must also be licensed under LGPLv3 and source code must be made available. Proprietary projects should review this constraint carefully.
last release 2022-12-11 (1342 days) · last repo commit 2026-07-20 · 74 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 2,814,514 downloads/mo, #2,878 on PyPI
Alternatives
Verify before relying
pip install pymeeus
from pymeeus.Epoch import Epoch
from pymeeus.Angle import Angle
mydate = Epoch(1992, 10, 13.0)
angle = Angle(11.94524)- Current Python version support beyond the classifiers (2.7, 3.6) listed—whether it works on modern Python versions is not explicitly stated.
- Precision and accuracy of astronomical calculations relative to the original Meeus reference or other libraries.
- Whether the package is suitable for production-grade astronomical applications or primarily for educational use.
What it is and what it does
PyMeeus is a pure-Python library that translates the algorithms from Jean Meeus's 'Astronomical Algorithms' (2nd Edition, 1998) into executable code. It provides classes and methods for computing celestial phenomena—lunar phases, planetary positions, solar events, eclipse data, and time conversions—without external compiled dependencies. The library is designed for simplicity and readability rather than maximum speed or precision.
The package is organized as a collection of modules (Epoch, Angle, Coordinates, Moon, Sun, Planet, Saturn, Jupiter, etc.), each exposing classes and methods for specific astronomical tasks. It is commonly used in educational settings, hobbyist astronomy projects, and applications where ease of understanding and minimal setup matter more than professional-grade accuracy or performance.
Use it for
- Calculate the Moon's phase and position on a given date for educational astronomy projects or planetarium software.
- Compute sunrise, sunset, and solar event times (solstices, equinoxes) for a specific location and date.
- Determine the positions of planets and Jupiter's Galilean moons for amateur astronomy observation planning.
- Convert between different astronomical time scales (UTC, TT, JDE) and epoch formats in calendar applications.
- Verify or teach the classical Meeus algorithms in an academic or tutorial context without external dependencies.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need straightforward astronomical calculations for education, hobby projects, or applications where simplicity and minimal dependencies outweigh the need for cutting-edge precision or frequent updates.
The library is stable, well-documented, and carries no known vulnerabilities. However, verify Python version compatibility first and consider whether other libraries better suit production-grade use cases. The long release gap since 2022-12-11 suggests infrequent maintenance.
Install
pymeeus on PyPI
Before you install
Install friction is high—the package is distributed as a source tarball with no compiled dependencies, but has not been updated since 2022-12-11, despite the repository remaining active. Maintenance status is marked active, though the release gap suggests infrequent updates.
PyMeeus is a library of multiple modules, not a single module—you must import specific submodules (e.g., `from pymeeus.Epoch import Epoch`) rather than `import pymeeus` directly.
License in practice
PyMeeus is licensed under LGPLv3 (copyleft). This means you may use, modify, and distribute it freely, but any derivative work must also be licensed under LGPLv3 and source code must be made available. Proprietary projects should review this constraint carefully.
Quickstart
pip install pymeeus
from pymeeus.Epoch import Epoch
from pymeeus.Angle import Angle
mydate = Epoch(1992, 10, 13.0)
angle = Angle(11.94524)Verify before relying
- Current Python version support beyond the classifiers (2.7, 3.6) listed—whether it works on modern Python versions is not explicitly stated.
- Precision and accuracy of astronomical calculations relative to the original Meeus reference or other libraries.
- Whether the package is suitable for production-grade astronomical applications or primarily for educational use.
Package facts
| License | LGPLv3 copyleft |
| Python support | Not specified |
| Install friction | High. Source build required |
| Runtime dependencies | None |
| Maintenance | Actively maintained 1,342 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 2,814,514 / month, #2,878 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaEnvironment :: ConsoleIntended Audience :: DevelopersIntended Audience :: EducationIntended Audience :: Science/ResearchLicense :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)Operating System :: OS IndependentProgramming Language :: Python :: 2.7Programming Language :: Python :: 3.6Topic :: Scientific/Engineering :: Astronomy |
Evidence: PyMeeus-0.5.12.tar.gz
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “astronomical algorithms python”
- PyMeeusPyMeeus implements astronomical algorithms from Jean Meeus's…
- pyerfaPyERFA wraps the ERFA C library (Essential Routines for Fundamental…
- astroqueryAstroquery provides a Python interface to query and retrieve data…
Give your agent the search over MCP, or paste the wish link into any chat.
More Astronomy packages
Albumentations applies image transformations to training data, supporting classification, segmentation, object detection, and pose estimation with a unified API for images, masks, bounding boxes, and keypoints.
Install it if you need a unified, production-grade augmentation API for computer vision tasks.
Converts dates between the Gregorian calendar and 15+ alternative calendar systems including Hebrew, Islamic, Julian, French Republican, Mayan, and others, plus calculates holidays across North American, Jewish, and other traditions.
Install only if you actually need multi-calendar support; the single pymeeus dependency is manageable.
Converts between Julian dates and Gregorian or Julian calendar dates, storing Julian dates as pairs of floating-point numbers for maximum precision.
However, be aware that it will not receive bug fixes or updates—verify that its behavior matches your requirements before committing to it in a production system.
PyERFA wraps the ERFA C library (Essential Routines for Fundamental Astronomy) as NumPy universal functions, exposing key astronomy algorithms for scalar or array inputs.
Install it if you need fundamental astronomy calculations or if another package depends on it.
PyEphem computes high-precision positions of planets, moons, stars, comets, and asteroids in the sky for any observer location and date, using C-based numeric routines from the XEphem astronomy application.
Adds a quaternion dtype to NumPy, enabling efficient quaternion arithmetic and array operations with native NumPy integration.
See also jplephem · pyorbital · skyfield-data · skyfield · sgp4 · reproject · gwcs · photutils