Solarius
Solarius is a Python library for calculating your precise solar return — the exact moment the Sun returns to the same ecliptic longitude it occupied at your birth — according to the Gregorian calendar. This real birthday and can differ from your civil birthday in a given future year due to leap years, etc.
To give you accurate results anywhere in the world, Solarius uses:
- skyfield to compute precise positions of celestial bodies.
- geopy to map the names of cities and countries to coordinates.
- timezonefinder for mapping geographical coordinates to timezones.
- pytz to convert between UTC and local times using regional daylight-saving rules.
📦 Installation
pip install solarius
Built for Python 3.12 or above.
🚀 Quick Start
from solarius.model import SolarReturnCalculator
calculator = SolarReturnCalculator(ephemeris_file="de421.bsp")
# Predict without printing
date_str, time_str, tz_name = calculator.predict(
official_birthday="18-01-1996",
official_birth_time="02:30",
birth_country="France",
birth_city="Paris",
current_country="France",
current_city="Paris",
target_year="2026"
)
print(date_str, time_str, tz_name)
# Or use the convenience printer
calculator.print_real_birthday(
official_birthday="18-01-1996",
official_birth_time="02:30",
birth_country="France",
birth_city="Paris",
current_country="France",
current_city="Paris",
target_year="2026"
)
📚 API Reference
See here
Metadata
Release files for solarius 0.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| solarius-0.1.2.tar.gz | 5.2 kB | Without provenance | Details for solarius-0.1.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| solarius-0.1.2-py3-none-any.whl | Python 3 | none | any | Details for solarius-0.1.2-py3-none-any.whl |
Total release size: 11.6 kB
Release files / solarius-0.1.2.tar.gz
| Download URL | solarius-0.1.2.tar.gz |
|---|---|
| Size | 5.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f8f96d05053d772fda101a0426fe12664d4a3f818be7de4256f879a97df1b535
|
|
BLAKE2b-256 checksum How to use checksums |
23bf84e8a7e4a9e585b84a967d25a9de3bbf2c998882abc825de5474dacb0461
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.11
|
Release files / solarius-0.1.2-py3-none-any.whl
| Download URL | solarius-0.1.2-py3-none-any.whl |
|---|---|
| Size | 6.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
dfdd493c5b2432c3bdba842d064560887570227c821134f04fe5025f2918b46f
|
|
BLAKE2b-256 checksum How to use checksums |
b8c876f5091609bd9b23c2e5d5ff14dc3504aca605baee5aaf015f01e2be8b8d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.11
|
Security for solarius 0.1.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.