SDKs & client libraries
Plain REST, plus a typed Node.js SDK today.
Every one of the 311 endpoints is REST + JSON over HTTPS, documented in an OpenAPI 3.1 spec you can drop into Postman or any code generator right now. The official Node.js / TypeScript SDK is open source on GitHub today. SDKs for Flutter / Dart and React Native are in development, with Python, PHP, Go, Ruby and Java to follow.
Open source · on npm
Node.js & TypeScript SDK.
The official lifeastroapi package is on npm and open source on GitHub — a fully-typed client for every one of the 311 endpoints (festivals, panchang calendar sheets, charts, dashas, Western, reports), with optional branded PDF reports. PDF rendering runs on your server and needs Puppeteer (a headless Chrome), installed separately — the PDF reports guide covers setup, disk and memory, fonts, Docker and serverless.
JavaScript / TypeScript
- Fully-typed — every REST endpoint, with autocomplete
- Zero runtime dependencies — Node 18+, serverless & edge
- Ships ESM + CommonJS with bundled .d.ts types
- Typed errors, automatic retries & timeouts built in
- Branded, white-label PDF reports (optional)
import { LifeAstro } from "lifeastroapi";
const client = new LifeAstro({ apiKey: "dv_live_…" });
// A Vedic birth chart
const planets = await client.chart.planets({
date: "1990-01-15", time: "10:30",
tz: "Asia/Kolkata", lat: 19.07, lon: 72.87,
});Mobile — in development
Flutter & React Native SDKs.
The same 300+ typed endpoints, with PDF report rendering done the native way on each platform — dart-pdf widgets on Flutter, expo-print / html-to-pdf on React Native.
Flutter / Dart
Pure-Dart client for every endpoint (Android, iOS, web, desktop) + Flutter-native white-label PDF reports built on dart-pdf widgets — the flagship 130+ page Brihad Kundli renders on-device.
dart pub add lifeastroapi # on releaseView package React Native
RN-safe typed client (no URLSearchParams pitfalls) + on-device PDF reports via expo-print or react-native-html-to-pdf — one reportPdf() call per report, branding built in.
npm i lifeastroapi-react-native # on releaseView package No install needed
Prefer no SDK at all?
Both of these are live right now and work with your existing dv_live_… key.
In development
More language SDKs.
Each library wraps the REST API with idiomatic types, auth handling and retries — just like the Node SDK. The install commands below are indicative; final package names land at release.
Python
Pythonic client with sync and async support, complete with type hints.
pip install lifeastroapiPHP
Composer package for PHP 8+, PSR-4 autoloaded and framework-agnostic.
composer require lifeastro/sdkGo
Idiomatic Go module with first-class context and error handling.
go get github.com/ayanshulife/lifeastro-goRuby
Ruby gem for Rails apps, background jobs and scripts.
gem install lifeastroapiJava / Kotlin
JVM client for Java and Kotlin — Android-friendly, Maven & Gradle ready.
implementation("com.lifeastro:sdk")Start building in minutes.
Grab a free dv_live_… key and call the API over plain REST from any language — or generate a client from the OpenAPI spec. SDK releases are announced to every account by email.