---
id: pyluach
version: "2.3.0"
license: unclear
license_treatment: permissive
maintenance: active
---

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

License: permissive · Maintenance: active · Downloads: 4.9M/mo

## 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 above — 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

pip install pyluach
uv add pyluach
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_current
- Install friction: low
- Maintenance: active
- Downloads: 4.9M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

hebrew calendar conversion, jewish date gregorian, torah parsha reading, hebrew holiday dates, jewish calendar library, luach hebrew dates, hebrew-calendar, date-conversion, jewish-holidays

[View on SkillFed](https://skillfed.io/packages/pyluach) · [View on PyPI](https://pypi.org/project/pyluach/)