The askvedicguru CLI (short alias: avg) wraps the SDK so you can query Vedic astrology data without writing code.

Install

npm install -g askvedicguru

Authenticate

avg configure --key avg_xxxxxxxxxxxxxxxxxxxx

Or set the environment variable:

export ASKVEDICGURU_API_KEY=avg_xxxxxxxxxxxxxxxxxxxx

Commands

Command	Description
avg configure	Save API key to ~/.askvedicguru/config.json
avg profiles list	List all saved profiles
avg profiles create	Create a new birth profile
avg chart full <id>	Full birth chart — planets, houses, ascendant
avg chart details <id>	Basic details — ascendant, moon sign, nakshatra
avg rashifal <id>	Horoscope for daily / weekly / monthly / yearly period
avg keys list	List API keys and account credits
avg keys create <name>	Create a new API key
avg keys revoke <id>	Revoke an API key

Quick example

# Create a profile
avg profiles create \
  -n "Arjun Sharma" \
  -g male \
  -d 1990-06-15 \
  -t 06:30 \
  -z Asia/Kathmandu \
  -l "Kathmandu, Nepal" \
  --lat 27.7172 --lon 85.3240

# Get monthly rashifal in BS calendar
avg rashifal <profileId> --period monthly --calendar bs

# Get full birth chart as JSON
avg chart full <profileId> --json

Output flags

Most read commands accept --json to print the raw API response instead of the formatted display:

avg chart full <profileId> --json | jq '.planets[] | select(.sign == "Scorpio")'

Configuration priority

1. ASKVEDICGURU_API_KEY environment variable
2. ~/.askvedicguru/config.json (written by avg configure)