vedic-astro

Accurate Vedic astrology calculations with astronomia, sidereal ayanamsha options, Panchang, GunMilan, and South Indian Kundali chart data.

Features (Planned)

- Planetary Positions (Swiss Ephemeris)
- Moon Sign (Rashi) & Nakshatra
- Panchang (Tithi, Yoga, Karana, sunrise/sunset)
- Gun Milan (Ashta Koota 36-guna, configurable variants)
- Kundali (D1) South Indian chart data, aspects (Drishti), Shadbala
- Daily Transits (data-only, no fabricated text)

vedic-astro

Accurate Vedic astrology calculations in TypeScript: Panchang, Nakshatra, Moon Sign, Planetary Positions, Kundali, Gun Milan, and rule-based daily guidance.

Install

``bash
npm install vedic-astro
`

Quick Start

`ts
import { getPlanetaryPositions, getPanchang } from 'vedic-astro';
import { getDailyAdvice } from 'vedic-astro';

const location = { latitude: 28.6139, longitude: 77.2090 };
const iso = new Date().toISOString();

(async () => {
const eph = await getPlanetaryPositions({ iso }, location);
const panchang = getPanchang(eph, location);
const advice = await getDailyAdvice(iso, location);

console.log(panchang.tithi, panchang.nakshatra);
console.log(advice.header.rashi, advice.ratingStars, advice.categories.career);
})();
`

API

- getPlanetaryPositions({ iso }, location) → sidereal longitudes for Sun, Moon, Mercury–Saturn, Rahu/Ketu.
- getPanchang(positions, location) → Tithi, Nakshatra, Yoga, Karana, sunrise/sunset/moonrise, auspicious/inauspicious windows.
- getDailyAdvice(iso, location) → Deterministic daily sentences based on actual Panchang and gochar metrics.
- getDailyGochar(iso, location) → Category scores, lucky number/color/time.
- getMoonSign(positions) → Moon sign and ruler.
- getKundali(positions) → Ascendant + whole-sign houses and planetary placements.
- getGunMilan(bride, groom, options)` → Ashtakoota score breakdown.

Accuracy Notes

- Astronomy: pure-JS algorithms (Meeus/VSOP via astronomia), sidereal via configurable ayanamsha (default Lahiri).
- Time windows: sunrise/sunset/moonrise via suncalc.
- Guidance: rule-based sentences mapped to real tithi and nakshatra; no randomization.

License

MIT