SDKs

Official TypeScript and Python SDKs wrap the REST API with typed methods and automatic retries.

TypeScript

Install

npm install gitstrology

Usage

import { Gitstrology } from "gitstrology";

const gs = new Gitstrology({ apiKey: process.env.GITSTROLOGY_API_KEY });

// Natal chart
const chart = await gs.natalChart({
  date: "1990-03-15",
  time: "14:30",
  latitude: 44.8,
  longitude: 20.4,
});

console.log(chart.sunSign); // "pisces"

// Horoscope
const h = await gs.horoscope({ sign: "aries" });
console.log(h.summary);

Python

Install

pip install gitstrology

Usage

from gitstrology import Gitstrology
import os

gs = Gitstrology(api_key=os.environ["GITSTROLOGY_API_KEY"])

# Natal chart
chart = gs.natal_chart(
    date="1990-03-15",
    time="14:30",
    latitude=44.8,
    longitude=20.4,
)

print(chart["sunSign"])  # "pisces"

# Horoscope
h = gs.horoscope(sign="aries")
print(h["summary"])

Available methods

Both SDKs read the key from GITSTROLOGY_API_KEY automatically.