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

npm install vedic-astro

Quick Start

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