ankitjh4/indic-ai-skills/vedic-astrology

Vedic Astrology Skill

Generate and interpret complete Vedic astrology birth charts using multiple systems including Krishnamurthi Paddhati (KP), classical Parashara principles, and traditional Vedic texts.

Overview

This skill combines three powerful Python libraries for comprehensive Vedic astrology:

1. flatlib - Traditional astrology calculations with Swiss Ephemeris
2. VedicAstro - Krishnamurthi Paddhati (KP) system specialization
3. jyotishganit - Professional grade Vedic calculations with NASA JPL ephemeris

All three libraries are integrated to provide:

• Complete birth chart generation (D1-D60 divisional charts)
• Panchanga (five limbs of time)
• Vimshottari Dasha periods
• Shadbala (six-fold planetary strength)
• Ashtakavarga point system
• KP system significators and sublords
• Horary (Prasna) chart generation
• Traditional interpretations from classical texts

Installation

The scripts automatically install required libraries on first run:

# All dependencies auto-installed:
# - flatlib (from sidereal branch)
# - vedicastro  
# - jyotishganit
# - pyswisseph
# - skyfield

Usage

Generate Complete Birth Chart

# Basic natal chart
bun scripts/generate-chart.ts \
  --date "1990-07-15" \
  --time "14:30:00" \
  --lat 28.6139 \
  --lon 77.2090 \
  --tz 5.5 \
  --name "Sample Person" \
  --place "New Delhi"
 
# Saves to: Charts/sample-person-chart.json

Output includes:

• All planetary positions (9 grahas)
• Ascendant and house cusps
• D1-D60 divisional charts
• Panchanga details
• Vimshottari Dasha periods
• Shadbala calculations
• Ashtakavarga points
• KP significators and sublords

Horary (Prasna) Chart

# Question-based horary chart
bun scripts/generate-horary.ts \
  --question "Will I get the job?" \
  --lat 19.0760 \
  --lon 72.8777 \
  --tz 5.5 \
  --place "Mumbai"
 
# Uses current time or specify:
bun scripts/generate-horary.ts \
  --question "Should I invest in this business?" \
  --date "2024-03-15" \
  --time "10:45:00" \
  --lat 12.9716 \
  --lon 77.5946 \
  --tz 5.5 \
  --place "Bangalore"

Interpret Chart

# Get detailed interpretation
bun scripts/interpret-chart.ts \
  --chart "Charts/sample-person-chart.json" \
  --focus "career" \
  --system "kp"
 
# Focus areas: career, marriage, health, wealth, education, children
# Systems: kp, parashara, combined

Dasha Predictions

# Current dasha period analysis
bun scripts/analyze-dasha.ts \
  --chart "Charts/sample-person-chart.json" \
  --date "2024-03-15"
 
# Get upcoming events
bun scripts/analyze-dasha.ts \
  --chart "Charts/sample-person-chart.json" \
  --period "next-year"

Panchanga (Daily Almanac)

# Today's panchanga
bun scripts/panchanga.ts \
  --lat 28.6139 \
  --lon 77.2090 \
  --tz 5.5
 
# Specific date
bun scripts/panchanga.ts \
  --date "2024-04-15" \
  --lat 13.0827 \
  --lon 80.2707 \
  --tz 5.5 \
  --place "Chennai"

Transit Analysis

# Current planetary transits
bun scripts/transit.ts \
  --chart "Charts/sample-person-chart.json"
 
# Future transit
bun scripts/transit.ts \
  --chart "Charts/sample-person-chart.json" \
  --date "2024-06-01"

Compatibility (Synastry)

# Match two charts
bun scripts/compatibility.ts \
  --chart1 "Charts/person1-chart.json" \
  --chart2 "Charts/person2-chart.json"
 
# Includes:
# - Kuta/Guna matching
# - Mangal Dosha check
# - Nadi, Bhakuta, Gana compatibility
# - Overall score and recommendations

Key Concepts

Krishnamurthi Paddhati (KP) System

What makes KP unique:

• Uses 249 subdivisions (sublords) instead of just 27 nakshatras
• Planet as significator of houses > Planet posited in house
• More precise timing predictions
• Simplified rules compared to classical systems

KP Significators (ABCD):

• A: Planets in a house's constellation
• B: Planets in a house
• C: Planets aspecting a house
• D: Planets in aspect to house lord

Divisional Charts (Vargas)

Panchanga (Five Limbs)

1. Tithi - Lunar day (1-30)
2. Nakshatra - Moon's constellation (27 divisions)
3. Yoga - Sun-Moon combination (27 types)
4. Karana - Half of tithi (11 types)
5. Vaara - Weekday (7 days)

Vimshottari Dasha

120-year planetary period system:

• Ketu: 7 years
• Venus: 20 years
• Sun: 6 years
• Moon: 10 years
• Mars: 7 years
• Rahu: 18 years
• Jupiter: 16 years
• Saturn: 19 years
• Mercury: 17 years

Each Mahadasha divided into Antardashas, Pratyantardashas, etc.

Shadbala (Six-Fold Strength)

1. Sthanabala - Positional strength
2. Kaalabala - Temporal strength
3. Digbala - Directional strength
4. Cheshtabala - Motional strength
5. Naisargikabala - Natural strength
6. Drikbala - Aspectual strength

Minimum required strength (Rupas):

• Sun: 5, Moon: 6, Mars: 5, Mercury: 7
• Jupiter: 6.5, Venus: 5.5, Saturn: 5

Ashtakavarga

Point-based system showing strength in each sign:

• Sarvashtakavarga (SAV): Combined points from all planets
• Bhinnashatkavarga (BAV): Individual planet contributions
• Used for transit predictions and strength assessment

Output Format

Charts are saved as JSON with complete astrological data:

{
  "person": {
    "name": "Sample Person",
    "birth_date": "1990-07-15T14:30:00",
    "latitude": 28.6139,
    "longitude": 77.2090,
    "timezone": 5.5,
    "place": "New Delhi"
  },
  "ayanamsa": 23.87,
  "d1_chart": {
    "ascendant": {"sign": "Libra", "degrees": 12.45},
    "planets": [...],
    "houses": [...]
  },
  "divisional_charts": {
    "d9": {...},
    "d10": {...}
  },
  "panchanga": {
    "tithi": "Krishna Chaturthi",
    "nakshatra": "Pushya",
    "yoga": "Vyaghata",
    "karana": "Bava",
    "vaara": "Sunday"
  },
  "dashas": {
    "current_mahadasha": "Venus",
    "current_antardasha": "Moon",
    "periods": [...]
  },
  "kp_data": {
    "significators": {...},
    "sublords": {...}
  },
  "shadbala": {...},
  "ashtakavarga": {...}
}

Chart Interpretation Principles

House Significations (Parashara System)

1. 1st House (Lagna): Self, body, personality, general fortune
2. 2nd House: Wealth, family, speech, food, early education
3. 3rd House: Siblings, courage, communication, short journeys
4. 4th House: Mother, home, property, vehicles, happiness
5. 5th House: Children, education, intelligence, romance, speculation
6. 6th House: Enemies, diseases, debts, service, obstacles
7. 7th House: Spouse, marriage, partnerships, business
8. 8th House: Longevity, inheritance, occult, sudden events
9. 9th House: Father, dharma, fortune, higher education, long journeys
10. 10th House: Career, profession, status, authority, fame
11. 11th House: Gains, income, friends, ambitions, elder siblings
12. 12th House: Losses, expenses, foreign lands, spirituality, isolation

Planetary Natures

Natural Benefics:

• Jupiter (guru) - Great benefic
• Venus (shukra) - Lesser benefic
• Moon (chandra) - Benefic when waxing
• Mercury (budha) - Benefic when alone or with benefics

Natural Malefics:

• Saturn (shani) - Great malefic
• Mars (mangal) - Lesser malefic
• Sun (surya) - Mild malefic
• Rahu/Ketu - Shadow planets (malefic)

Functional Benefics/Malefics: Depends on ascendant and lordship of houses.

Yogas (Planetary Combinations)

Powerful Yogas:

• Raj Yoga: Combinations giving power, status
• Dhana Yoga: Wealth-giving combinations
• Neecha Bhanga Raj Yoga: Debilitation cancellation
• Gajakesari Yoga: Jupiter-Moon combination
• Mahapurusha Yogas: Pancha Mahapurusha combinations

Challenging Yogas:

• Kemadruma Yoga: Moon isolated (no planets in adjacent houses)
• Daridra Yoga: Poverty-giving combinations
• Kala Sarpa Yoga: All planets between Rahu-Ketu axis

Dasha Interpretation Rules

1. Mahadasha Lord:

• Natural significations of the planet
• Houses owned by the planet
• Houses occupied and aspected

1. Antardasha Lord:

• Relationship with Mahadasha lord
• Its own significations and house lordship

1. Transit Influence:

• Current position of dasha lords
• Aspects to natal positions
• Ashtakavarga strength in transit sign

KP Judgment Rules

For any event to manifest:

1. Significators must be present:

• Check house significations (ABCD method)
• Primary significators > Secondary > Tertiary

1. Dasha must be supportive:

• Current Mahadasha-Antardasha lords
• Must be significators of relevant houses

1. Sublord must promise:

• Cusp sublord more important than house lord
• Sublord shows final fructification

Example (Marriage timing):

• Houses: 2, 7, 11 (positive), avoid 1, 6, 10 (negative)
• Check significators of 2-7-11
• Dasha must run of these significators
• 7th cusp sublord should not be in 1-6-10 star lord

Traditional Texts Referenced

The interpretation incorporates wisdom from:

1. Brihat Parashara Hora Shastra - Foundation of Vedic astrology
2. Brihat Jataka (Varahamihira) - Classical text on natal astrology
3. Saravali (Kalyana Varma) - Comprehensive horoscopy
4. Phaladeepika (Mantreswara) - Results of planetary positions
5. Jataka Parijata (Vaidyanatha) - Natal astrology compendium
6. KP Readers (K.S. Krishnamurti) - KP system foundation

Environment Variables

Set these in Settings > Advanced if needed:

# Optional: Swiss Ephemeris path
SWISSEPH_PATH="/custom/path/to/ephe"
 
# Optional: Output directory
ASTRO_CHARTS_DIR="./Charts"

Technical Details

Ayanamsa Used:

• True Chitra Paksha (Lahiri) - Default
• Based on Spica star position
• ~23.87° for year 2024

Ephemeris Source:

• NASA JPL DE421 (jyotishganit)
• Swiss Ephemeris (flatlib, VedicAstro)
• Accuracy to arc-seconds

Coordinate System:

• Geocentric sidereal zodiac
• Whole sign house system (traditional)
• Equal house divisions

Common Use Cases

Career Guidance

# Generate chart and get career insights
bun generate-chart.ts --date "1990-05-20" --time "08:15:00" \
  --lat 18.5204 --lon 73.8567 --tz 5.5 --name "Client" --place "Pune"
  
bun interpret-chart.ts --chart "Charts/client-chart.json" --focus "career" --system "combined"

Marriage Timing

# Check marriage prospects
bun interpret-chart.ts --chart "Charts/client-chart.json" --focus "marriage"
 
# Check compatibility with partner
bun compatibility.ts --chart1 "Charts/person1.json" --chart2 "Charts/person2.json"

Health Analysis

# Health indicators
bun interpret-chart.ts --chart "Charts/client-chart.json" --focus "health"
 
# Check current dasha for health matters
bun analyze-dasha.ts --chart "Charts/client-chart.json"

Business Partnership

# Horary question
bun generate-horary.ts --question "Should I partner with this person?" \
  --lat 22.5726 --lon 88.3639 --tz 5.5 --place "Kolkata"
 
# Interpret horary chart using KP rules
bun interpret-chart.ts --chart "Charts/horary-*.json" --system "kp"

Muhurta (Auspicious Timing)

# Find auspicious time for event
bun panchanga.ts --date "2024-04-15" --lat 28.6139 --lon 77.2090 --tz 5.5