@askvedicguru/sdk

@askvedicguru/sdk

Official TypeScript/JavaScript SDK for AskVedicGuru — Vedic astrology data and AI insights via one API.

Install

npm install @askvedicguru/sdk
# or
bun add @askvedicguru/sdk

Works in Node.js 18+, Bun, Deno, and any environment with Fetch API support.

Quick start

import { AskVedicGuru } from '@askvedicguru/sdk'

const guru = new AskVedicGuru({
  apiKey: process.env.ASKVEDICGURU_API_KEY!,
})

// List profiles and get a birth chart
const profiles = await guru.profiles.list()
const chart = await guru.chart.full(profiles[0].id)
console.log(chart.moonSign)

Core resources

Resource	Methods
guru.profiles	list(), create()
guru.chart	full(), basicDetails(), planets(), ascendant(), nakshatra(), elements(), personality()
guru.panchang	get(), rashi()
guru.rashifal	get(), allSigns()
guru.dasha	get()
guru.predictions	get(), dailyInsight(), transits()
guru.dosha	get(), sadeSati(), remedies()
guru.strength	yogas(), ashtakavarga(), shadbala(), houseLords(), atmakaraka(), functional()
guru.conjunctions	get(), aspects(), vargas()
guru.chat	send() — AI Guru
guru.apiKeys	list(), create(), revoke()
guru.reports	kundli(), predictions(), compatibility() — returns PDF ArrayBuffer

Error handling

import {
  AskVedicGuru,
  AuthenticationError,
  InsufficientCreditsError,
  PlanRequiredError,
  RateLimitError,
} from '@askvedicguru/sdk'

try {
  const chart = await guru.chart.full(profileId)
} catch (err) {
  if (err instanceof InsufficientCreditsError) {
    console.error('Out of credits')
  } else if (err instanceof RateLimitError) {
    console.error(`Retry after ${err.retryAfter}s`)
  } else if (err instanceof PlanRequiredError) {
    console.error('Upgrade required')
  }
}

Full documentation

→ docs.askvedicguru.com