ekadashi 0.1.1

ISKCON compliant Ekadashi calculator using Swiss Ephemeris

Ekadashi Python Module

A lightweight Python module to calculate Vaishnava Ekadashi dates using astronomical calculations.

Ekadashi is a sacred fasting day observed on the eleventh lunar day (Ekadashi Tithi) of each fortnight in the Hindu lunar calendar. This module determines Ekadashi using Sun–Moon angular calculations and traditional Vaishnava observance rules.

Installation

Install the module from PyPI:

pip install ekadashi

Usage

Once installed, you can simply import the module in Python:

import ekadashi

# Check if today is Ekadashi
print(ekadashi.is_ekadashi("2026-03-29"))

# Find the next upcoming Ekadashi
print(ekadashi.next_ekadashi())

# Get all Ekadashi dates for a given year
print(ekadashi.get_ekadashi_dates(2026))

Example output:

{
 "date": "2026-03-29",
 "paksha": "Shukla",
 "days_until": 14
}

Features

• Accurate Ekadashi detection using astronomical tithi calculations
• Implements Vaishnava Ekadashi observance rules
• Handles Dashami purity and Arunodaya conditions
• Check if a specific date is Ekadashi
• Find the next upcoming Ekadashi
• Retrieve all Ekadashi dates for a given year
• Lightweight and easy to integrate into applications

Example

import ekadashi

dates = ekadashi.get_ekadashi_dates(2026)

for d in dates:
    print(d)

Use Cases

This module can be used for:

• Hindu calendar applications
• Panchang software
• Devotional reminder apps
• Astronomy-based calendar calculations
• Educational or research tools

Author

Developed and maintained by Hari Prajwal ❤️