skillfed

pyluach

A Python package for dealing with Hebrew (Jewish) calendar dates.

pyluach v2.3.0 4.9M downloads/30d#2,201 on PyPI71
Permissive license Active released

What it is and what it does

Pyluach is a Python library for working with Hebrew (Jewish) calendar dates. It handles bidirectional conversion between Hebrew and Gregorian calendars, date arithmetic (finding dates at given durations or differences), and calendar-specific lookups like holiday identification and weekly Torah portion assignments. The library also supports generating formatted Hebrew calendars in both text and HTML.

The package is designed for applications that need to work with Jewish calendar logic—scheduling religious observances, generating liturgical calendars, or building Hebrew date-aware applications. It requires Python 3.8 or later and has no external runtime dependencies, making it straightforward to integrate into existing projects.

Use it for:

  • Convert Hebrew dates to Gregorian and vice versa for calendar applications or event scheduling.
  • Identify which Torah portion is read on a given date for liturgical or educational purposes.
  • Look up Jewish holidays occurring on specific dates to highlight them in calendar interfaces.
  • Calculate the number of days between two dates across calendar systems for duration tracking.
  • Generate formatted Hebrew month or year calendars for printing or web display.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Converts between Hebrew and Gregorian calendar dates, calculates date differences and offsets, identifies holidays and weekly Torah portions, and generates Hebrew calendars in text and HTML formats.

Yes. Pyluach is production-stable, actively maintained, has no external dependencies, and fills a specific niche for Hebrew calendar handling. It carries no known vulnerabilities and is licensed permissively. Install it if your application needs to work with Hebrew dates, holidays, or Torah portions; skip it if you only need Gregorian calendar operations.

Install

pyluach on PyPI

pip

pip install pyluach

uv

uv add pyluach

poetry

poetry add pyluach

Installing pyluach

Before you install

Low friction installation with no runtime dependencies. Actively maintained since 2015, with recent releases and an active repository.

License in practice

MIT license permits unrestricted use, modification, and distribution with minimal obligations—suitable for commercial and private projects.

Quickstart

pip install pyluach

from pyluach import dates

today = dates.HebrewDate.today()
gregorian = today.to_greg()
holiday = today.holiday()

Package facts

License not declared (permissive)
Python support supports the current Python release (>=3.8)
Install friction low — pure-Python wheel
Runtime dependencies none
Maintenance actively maintained — 339 days since the last release
Last repo commit
First released
Downloads 4,908,069/month — #2,201 on PyPI (30-day window, as of 2026-08-14)
Known vulnerabilities none known (OSV.dev, checked 2026-08-14)

Evidence: pyluach-2.3.0-py3-none-any.whl

Keywords: hebrew, calendar, jewish, luach, gregorian, julian, days, dates, date, conversion, parsha, holiday

Development Status :: 5 - Production/StableIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Topic :: Software Development :: Libraries :: Python Modules

Tags

hebrew calendar conversionjewish date gregoriantorah parsha readinghebrew holiday datesjewish calendar libraryluach hebrew dates
hebrew-calendardate-conversionjewish-holidays

More Python Modules packages