Kundli Matching

Marriage compatibility in Python

Basic Usage

from vedika import VedikaClient

client = VedikaClient()

bride = {
    "datetime": "1995-03-20T14:30:00",
    "latitude": 28.6139,
    "longitude": 77.2090,
    "timezone": "+05:30"
}
groom = {
    "datetime": "1992-07-15T06:00:00",
    "latitude": 19.0760,
    "longitude": 72.8777,
    "timezone": "+05:30"
}

# Guna Milan takes the groom first, then the bride.
# V2 methods return the full response (success, data, billing, meta).
match = client.get_guna_milan(groom, bride)["data"]

print(f"Total Score: {match['total_points']}/{match['maximum_points']}")
print(f"Percentage: {match['percentage']}%")
print(f"Verdict: {match['match_result']}")

Guna Breakdown

# Access individual gunas
for guna in match["guna_kootas"]:
    status = "Matched" if guna["points"] == guna["maximum_points"] else "Not Matched"
    print(f"{guna['name']}: {guna['points']}/{guna['maximum_points']} - {status}")

Manglik Compatibility

# Check Manglik status for each partner
bride_mangal = client.get_doshas_v2("mangal-dosha", bride)["data"]
groom_mangal = client.get_doshas_v2("mangal-dosha", groom)["data"]

print(f"Bride Manglik: {bride_mangal['has_dosha']}")
print(f"Groom Manglik: {groom_mangal['has_dosha']}")
print(f"Compatible: {bride_mangal['has_dosha'] == groom_mangal['has_dosha']}")

# Details for one chart
print(f"Severity: {bride_mangal['severity']}")
print(f"Cancelled: {bride_mangal['is_cancelled']}")
print(f"Cancellations: {bride_mangal['cancellation_reasons']}")

South Indian (Porutham)

# South Indian method: Nakshatra Porutham
porutham = client.get_compatibility_v2("nakshatra-porutham", groom, bride)

print(porutham["data"])

Recommendations & Remedies

match = client.get_guna_milan(groom, bride)["data"]

# Access recommendations
print("Strengths:")
for strength in match["interpretation"]["strengths"]:
    print(f"  - {strength}")

print("\nConcerns:")
for concern in match["interpretation"]["challenges"]:
    print(f"  - {concern}")

print("\nRemedies:")
for remedy in match["remedies"]:
    print(f"  - {remedy}")

Batch Matching

from vedika import VedikaClient
import asyncio

async def match_multiple_profiles(bride, grooms):
    """Match one bride with multiple groom profiles."""
    client = VedikaClient()
    tasks = [
        asyncio.to_thread(client.get_guna_milan, groom, bride)
        for groom in grooms
    ]
    results = await asyncio.gather(*tasks)

    # Sort by score
    ranked = sorted(
        zip(grooms, results),
        key=lambda x: x[1]["data"]["total_points"],
        reverse=True
    )

    return ranked

# Usage
bride = {"datetime": "1995-03-20T14:30:00", "latitude": 28.6139, "longitude": 77.2090, "timezone": "+05:30"}
grooms = [
    {"datetime": "1992-07-15T06:00:00", "latitude": 19.0760, "longitude": 72.8777, "timezone": "+05:30"},
    {"datetime": "1990-12-25T10:00:00", "latitude": 13.0827, "longitude": 80.2707, "timezone": "+05:30"},
    {"datetime": "1993-08-08T15:30:00", "latitude": 22.5726, "longitude": 88.3639, "timezone": "+05:30"},
]

ranked_matches = asyncio.run(match_multiple_profiles(bride, grooms))
for groom, result in ranked_matches:
    match = result["data"]
    print(f"Score: {match['total_points']} - {match['match_result']}")

Generate Matching Report

def generate_match_report(match, bride_mangal, groom_mangal):
    """Generate a detailed matching report."""
    report = []
    report.append("=" * 50)
    report.append("KUNDLI MATCHING REPORT")
    report.append("=" * 50)

    report.append(f"\nOverall Score: {match['total_points']}/{match['maximum_points']} ({match['percentage']}%)")
    report.append(f"Verdict: {match['match_result']}\n")

    report.append("GUNA ANALYSIS:")
    report.append("-" * 30)
    for guna in match["guna_kootas"]:
        status = "MATCH" if guna["points"] == guna["maximum_points"] else "----"
        report.append(f"{guna['name']:15} {guna['points']}/{guna['maximum_points']}  [{status}]")

    report.append("\nMANGLIK STATUS:")
    report.append("-" * 30)
    report.append(f"Bride:  {'Manglik' if bride_mangal['has_dosha'] else 'Non-Manglik'}")
    report.append(f"Groom:  {'Manglik' if groom_mangal['has_dosha'] else 'Non-Manglik'}")

    if match["remedies"]:
        report.append("\nRECOMMENDED REMEDIES:")
        report.append("-" * 30)
        for remedy in match["remedies"]:
            report.append(f"  * {remedy}")

    return "\n".join(report)

# Usage
match = client.get_guna_milan(groom, bride)["data"]
bride_mangal = client.get_doshas_v2("mangal-dosha", bride)["data"]
groom_mangal = client.get_doshas_v2("mangal-dosha", groom)["data"]
print(generate_match_report(match, bride_mangal, groom_mangal))

Related APIs