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))