vittix / panchang

2.4.0 2026-08-13 15:07 UTC

Requires

• php: ^8.2 || ^8.3 || ^8.4
• psr/simple-cache: ^3.0

Requires (Dev)

• phpstan/phpstan: ^2.0
• phpunit/phpunit: ^11.0

MIT

• Vittix Panchang Dev

• php
• calendar
• laravel
• horoscope
• jyotish
• astrology
• kundli
• panchang
• vedic
• hindu

Published on Packagist.org on 2026-08-14 07:41 UTC

README

Accurate Vedic Panchang, Kundli, Astrology, Muhurta, and Festival calculations for PHP & Laravel.

Official demo: https://hindutithi.in/

Features

Panchang

• Daily Panchang and moment calculations
• Tithi, Nakshatra, Yoga, Karana, Vara
• Sunrise, sunset, and Muhurta helpers
• Lunar month, Janmarashi, and festival support
• Hindu calendar and Adhika Masa calculations

Astrology

• Birth chart (Kundli) generation
• Ascendant (Lagna) and house placement
• Planetary positions and Rashis
• Divisional charts (Vargas)
• Vimshottari Dasha and yogas
• Shadbala planetary strength

Installation

Install with Composer:

composer require vittix/panchang

Quick Start

<?php

declare(strict_types=1);

use DateTimeImmutable;
use DateTimeZone;
use Vittix\Panchang\Panchang;
use Vittix\Panchang\ValueObject\GeoLocation;

$panchang = Panchang::createDefault();
$date = new DateTimeImmutable('2026-08-04', new DateTimeZone('Asia/Kolkata'));
$location = new GeoLocation(latitude: 28.6139, longitude: 77.2090);

$day = $panchang->day($date, $location);

echo $day->tithiAtSunrise->nameEnglish();

Documentation

• Installation
• Quick Start
• Panchang
• Kundli
• Astrology
• API
• JSON API Schema
• Accuracy
• Examples

Public API

JSON / REST APIs

• PanchangService::createDefault()
• PanchangService::getForDate(DateTimeImmutable $date, GeoLocation $location)
• PanchangService::getAstronomyReport(DateTimeImmutable $date, GeoLocation $location)

Object-Oriented APIs

• Panchang::createDefault()
• Panchang::create(AstronomyEngineInterface $engine)
• Panchang::day(DateTimeImmutable $date, GeoLocation $location)
• Panchang::moment(DateTimeImmutable $moment, GeoLocation $location)
• Panchang::janmarashi(DateTimeImmutable $moment)
• Panchang::kundali(DateTimeImmutable $moment, GeoLocation $location)
• Panchang::varga(DateTimeImmutable $moment, GeoLocation $location, Varga $varga)
• Panchang::vimshottariDasha(DateTimeImmutable $moment)
• Panchang::shadbala(DateTimeImmutable $moment, GeoLocation $location)
• Panchang::yogas(DateTimeImmutable $moment, GeoLocation $location)
• Panchang::ascendant(DateTimeImmutable $moment, GeoLocation $location)

Scripts

• composer test
• composer analyse
• composer quality

Project Structure

• src/ engine, calculations, enums, and value objects
• tests/ unit and integration tests
• docs/ user guides and examples
• scripts/ repository tooling

License

This project is licensed under the MIT License.