Panchang

PyPI Python License: MIT CI

Bhāratīya calendar infrastructure for developers — Panchang, festivals, muhurat, regional calendars, and batch computation.

Built on a Rust computation engine with Swiss Ephemeris precision. Not an astrology API. It answers: "What is happening in the Bhāratīya calendar right now, at this location?"

from datetime import date
from panchang import panchang, calendar, Location

delhi = Location(lat=28.6139, lng=77.2090, tz="Asia/Kolkata")

# Daily Panchang
today = panchang.compute(date.today(), delhi)
print(today.tithi.paksha, today.tithi.name)  # "Shukla Dvitiya"
print(today.nakshatra.name)    # "Pushya"
print(today.nakshatra.pada)    # 3
print(today.sun.sunrise)       # 2026-03-03 06:42:18+05:30

# Festival dates
festivals = calendar.compute_festivals(2026, delhi)
for f in festivals[:3]:
    print(f"{f.name}: {f.date}")
# Makar Sankranti: 2026-01-14
# Vasant Panchami: 2026-02-01
# Maha Shivaratri: 2026-02-15

Install

pip install panchang

Requires Python 3.11+. Wheels available for Linux, macOS, and Windows.

Features

Panchang (Daily Calendar)

All 5 Panchanga elements with precise transition times (start/end to the second):

  • Tithi (lunar day) — with Paksha (Shukla/Krishna)
  • Nakshatra (lunar mansion) — with Pada (1-4)
  • Yoga (Sun-Moon combination)
  • Karana (half-tithi)
  • Vara (weekday)

Sun & Moon

  • Sunrise/sunset using Hindu rising model (disc center at horizon, Bhāratīya atmospheric refraction)
  • Location-aware computation for any lat/lng/timezone

Muhurat (Auspicious Windows)

  • Rahu Kalam, Yama Gandam, Gulika Kalam
  • Abhijit Muhurat
  • Choghadiya (16 windows per day — 8 day + 8 night)

Festivals

55+ Hindu festivals astronomically computed for any year:

  • Tithi-based: Diwali, Holi, Janmashtami, Ram Navami, Ganesh Chaturthi, Navaratri, ...
  • Sankranti-based: Makar Sankranti, Pongal, Vishu, Bihu, ...
  • Nakshatra-based: Onam (Thiruvonam)
  • Ekadashi: All 24 per year with Smartha and Vaishnava dates — 26 in Adhika-maas years (Padmini + Parama, flagged is_adhik)
  • Vrat dates: Pradosh, Sankashti Chaturthi, Amavasya, Purnima (~60 per year)

Festival definitions are data-driven (YAML, not hardcoded) with year-agnostic astronomical rules. Each resolved date includes a reasoning string explaining the determination.

Regional Calendars

8 regional calendar systems with proper era numbering:

  • Solar: Tamil, Bengali, Malayalam, Kannada
  • Lunar: Hindi, Marathi, Telugu, Gujarati
  • Era support: Vikram Samvat, Shaka Samvat, Bangabda, Kollavarsham, Thiruvalluvar, 60-year Jovian cycle

Lunar Months

  • Both Amant (South Bhārat) and Purnimant (North Bhārat) systems
  • Adhik Maas (intercalary month) and Kshaya Maas detection

Shraddha Tithi

Death anniversary date resolution — given a death date, computes the Shraddha date for any target year using the lunar tithi and month.

Batch Computation

Full-year or date-range Panchang in a single call:

from panchang import batch, Location

delhi = Location(lat=28.6139, lng=77.2090, tz="Asia/Kolkata")
year_data = batch.compute_year(2026, delhi)  # 365 days of Panchang

Accuracy

All computations use the Swiss Ephemeris (Moshier analytical model) with Lahiri/Chitrapaksha Ayanamsa — the Government of Bhārat standard.

Cross-validated against Drik Panchang for 2026-02-24, Delhi:

Element Drik Panchang Panchang Delta
Sunrise 06:51 06:55 ~4 min
Tithi Shukla Saptami until 07:01 Shukla Saptami until 07:02 ~1 min
Nakshatra Krittika until 15:07 Krittika until 15:07 exact
Yoga Indra until 07:24 Indra until 07:23 ~1 min
Karana Vanija until 07:01 Vanija until 07:02 ~1 min
Rahu Kalam 15:26-16:52 15:24-16:48 ~2 min

All element names match exactly. Timing differences are 1-5 minutes due to sunrise geometric model variations.

Architecture

Rust core + Python API. All astronomical math runs in Rust via PyO3, giving C-level performance with a Pythonic interface.

Python (pydantic models, typed API)
  └── Rust via PyO3 (panchang, festivals, muhurat, batch)
        └── Swiss Ephemeris C (planetary positions via FFI)

Performance (Rust benchmarks):

  • Full Panchang: ~3.7 ms
  • Sunrise: ~29 µs
  • All 9 planets: ~7 µs

Development

# Setup
uv venv
uv pip install -e ".[dev]"

# Build Rust extension
maturin develop --uv

# Run tests
uv run pytest tests/ -v
cargo test --manifest-path crates/panchang-core/Cargo.toml -- --test-threads=1

# Lint
uv run ruff check python/ tests/
cargo clippy --manifest-path crates/panchang-core/Cargo.toml -- -D warnings

Tech Stack

Layer Technology
Computation Rust + PyO3
Ephemeris Swiss Ephemeris (vendored C, Moshier model)
Python 3.11+ with Pydantic v2
Build maturin + uv
Testing pytest + proptest + criterion
CI GitHub Actions + maturin-action

Contributing

Contributions welcome! Please open an issue first to discuss what you'd like to change.

# Run the full check suite before submitting
uv run ruff check python/ tests/
uv run pytest tests/ -v
cargo test --manifest-path crates/panchang-core/Cargo.toml -- --test-threads=1
cargo clippy --manifest-path crates/panchang-core/Cargo.toml -- -D warnings

License

MIT

Project links

Data verified by PyPI on Jul 4, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for saucam from gravatar.com saucam

Credits

Author: vibz.art

GitHub Statistics

Data verified by PyPI on Jul 4, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python >=3.11

Provides Extra

dev

Tags

panchang hindu-calendar vedic astrology nakshatra tithi muhurat bharatiya-calendar

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

panchang-0.2.15-cp313-cp313-win_amd64.whl (477.6 kB view details)

Uploaded CPython 3.13Windows x86-64

panchang-0.2.15-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (624.0 kB view details)

Uploaded CPython 3.13manylinux: glibc 2.17+ x86-64

panchang-0.2.15-cp313-cp313-macosx_11_0_arm64.whl (551.5 kB view details)

Uploaded CPython 3.13macOS 11.0+ ARM64

panchang-0.2.15-cp312-cp312-win_amd64.whl (477.9 kB view details)

Uploaded CPython 3.12Windows x86-64

panchang-0.2.15-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (624.5 kB view details)

Uploaded CPython 3.12manylinux: glibc 2.17+ x86-64

panchang-0.2.15-cp312-cp312-macosx_11_0_arm64.whl (552.1 kB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

panchang-0.2.15-cp311-cp311-win_amd64.whl (478.3 kB view details)

Uploaded CPython 3.11Windows x86-64

panchang-0.2.15-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (625.7 kB view details)

Uploaded CPython 3.11manylinux: glibc 2.17+ x86-64

panchang-0.2.15-cp311-cp311-macosx_11_0_arm64.whl (555.5 kB view details)

Uploaded CPython 3.11macOS 11.0+ ARM64

File details

Details for the file panchang-0.2.15-cp313-cp313-win_amd64.whl.

File metadata

  • Download URL: panchang-0.2.15-cp313-cp313-win_amd64.whl
  • Upload date:
  • Size: 477.6 kB
  • Tags: CPython 3.13, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for panchang-0.2.15-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 9d7820d5b202038e143e53cb6d551a57e0ef2adaa31060269b760cd6a74697b8
MD5 6f7c3aac919cffc05388dc99410e9c1d
BLAKE2b-256 ee7acf1009a868b178c06e5c209a76284d3c3a9cdf1c407cca6a4c52a7500c18

See more details on using hashes here.

Provenance

The following attestation bundles were made for panchang-0.2.15-cp313-cp313-win_amd64.whl:

Publisher: release.yml on vibzart/panchang

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file panchang-0.2.15-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for panchang-0.2.15-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 5fda3bc591e7d7c1596d28445ea17d139a48ab37e915ee26f7a1b597b1c3869d
MD5 df5be2147c81e4f77264f22099c392c4
BLAKE2b-256 c50edbdb95f0258b7a8e2d16d86ce5897ca83ffa40d80e13122bdd57ac3cfc86

See more details on using hashes here.

Provenance

The following attestation bundles were made for panchang-0.2.15-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release.yml on vibzart/panchang

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file panchang-0.2.15-cp313-cp313-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for panchang-0.2.15-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 c6e3497ff582aeca736c84759d0b7b70831fa81cabae1917447de22a6396c5be
MD5 c452a909d7e0abdbdaa866bb41ced520
BLAKE2b-256 2d20ed0d54fb01cb70c378d65d08eb58eedf43629c65b0a31652302e132a1669

See more details on using hashes here.

Provenance

The following attestation bundles were made for panchang-0.2.15-cp313-cp313-macosx_11_0_arm64.whl:

Publisher: release.yml on vibzart/panchang

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file panchang-0.2.15-cp312-cp312-win_amd64.whl.

File metadata

  • Download URL: panchang-0.2.15-cp312-cp312-win_amd64.whl
  • Upload date:
  • Size: 477.9 kB
  • Tags: CPython 3.12, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for panchang-0.2.15-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 0e94603f1f24614edd8b78eb064e6471bf115dddcf2a4de6af1eb0ea0d5f4140
MD5 635f3f50e8297bb8cb8f2393c032286c
BLAKE2b-256 1706e901c6aedc8e90fb2c6297b3c83c5e99536f090c92f6f4973f8b0ecdd79c

See more details on using hashes here.

Provenance

The following attestation bundles were made for panchang-0.2.15-cp312-cp312-win_amd64.whl:

Publisher: release.yml on vibzart/panchang

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file panchang-0.2.15-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for panchang-0.2.15-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 d907911f788610b6a9c25888b0880506a7d18b4c582c47e3f99bd787f23b9445
MD5 c3bdc555dd1b0b4ab8702c9a2f920067
BLAKE2b-256 2f24da24e6e91f00757fbe9349a9f9a48c72bbc565eb2ef9b9bb9bce0de7b904

See more details on using hashes here.

Provenance

The following attestation bundles were made for panchang-0.2.15-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release.yml on vibzart/panchang

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file panchang-0.2.15-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for panchang-0.2.15-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 df7a2dab60eacc26f2bc6f85682d889c1166c5abea85cc70c104c67dc97c1ed0
MD5 8b1ce31f73da43a8494e881381797093
BLAKE2b-256 8146d1cc06603d08a3210888990e5e95b48f0384bcbe0dad90890bf706c86e16

See more details on using hashes here.

Provenance

The following attestation bundles were made for panchang-0.2.15-cp312-cp312-macosx_11_0_arm64.whl:

Publisher: release.yml on vibzart/panchang

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file panchang-0.2.15-cp311-cp311-win_amd64.whl.

File metadata

  • Download URL: panchang-0.2.15-cp311-cp311-win_amd64.whl
  • Upload date:
  • Size: 478.3 kB
  • Tags: CPython 3.11, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for panchang-0.2.15-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 b07d891e87911fcd8c350536a168aff02cfa8c7cba153ed8fcef95b0b17d59aa
MD5 84ae212ec85784a04b38eb429b637c76
BLAKE2b-256 40774a63c64820fa4a4171868070cf375227c2568a9f86345119606d749a9313

See more details on using hashes here.

Provenance

The following attestation bundles were made for panchang-0.2.15-cp311-cp311-win_amd64.whl:

Publisher: release.yml on vibzart/panchang

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file panchang-0.2.15-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for panchang-0.2.15-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 7937e88bb976ba8de30af2eebadc5299efa3feef1e250f569906ef9fad3e3171
MD5 90b4d6bae8bbb63d098db0267fc8b72d
BLAKE2b-256 e39f919dc42774d65b699a4fde8c3f89c380a9e1ba67d89c08260e505967e7a4

See more details on using hashes here.

Provenance

The following attestation bundles were made for panchang-0.2.15-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release.yml on vibzart/panchang

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file panchang-0.2.15-cp311-cp311-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for panchang-0.2.15-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 c79cece731d2883ce6356f591e6ad2e12f80a751635889b5bb923890712d68df
MD5 fec3c24f15f02b4b3feaef6301f67343
BLAKE2b-256 a15e10f333474eb7530d764adb6a67948aa6b8c29f3f2b3a36a79494cc4c728f

See more details on using hashes here.

Provenance

The following attestation bundles were made for panchang-0.2.15-cp311-cp311-macosx_11_0_arm64.whl:

Publisher: release.yml on vibzart/panchang

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.2.15 This release

9 files

0.2.14

9 files

0.2.13

9 files

0.2.12

9 files

0.2.11

9 files

0.2.10

9 files

0.2.9

9 files

0.2.8

9 files

0.2.7

9 files

0.2.6

9 files

0.2.5

9 files

0.2.4

9 files

0.2.3

9 files

0.2.2

9 files

0.2.1

9 files

0.2.0

3 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page