# SylarLong/iztro

⭐This is a lightweight kit for generating astrolabes for Zi Wei Dou Shu (The Purple Star Astrology), an ancient Chinese astrology. It allows you to obtain your horoscope and personality analysis. 支持多语言轻量级获取紫微斗数排盘信息的javascript开源库。

Repository: https://github.com/SylarLong/iztro
Canonical: https://ross.abutalabs.com/products/iztro
Homepage: https://iztro.com
Language: TypeScript
License: MIT
License Family: permissive
Topics: astrolabe, astrology, horoscope, ziweidoushu, chinese-astrology, javascript, npm, typescript, natal-chart
Last push: 2026-08-19T15:46:01+00:00

## Health v2 (maintenance only)
Score: 94/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 98, release rhythm 98, longevity 80
- inputs: {"age_days": 1133, "days_push": 14, "days_rel": 18, "gap_med": 25.5, "n_releases_24m": 11}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4094, forks 663 (observed 2026-08-28T04:08:34.666813+00:00)

## What it is
A lightweight, multilingual TypeScript/JavaScript library for generating Zi Wei Dou Shu (Purple Star Astrology) natal charts and horoscope data from birth date, time, and gender. It computes star placements, zodiac signs, and personality analysis data for use in applications.

## Use cases
- generate a zi wei dou shu natal chart from birth date
- build an astrology app that computes purple star astrolabes
- get horoscope and personality analysis from birth data
- calculate chinese zodiac and star signs in javascript
- render a ziweidoushu star chart in a web app
- add multilingual purple star astrology charting to a project

## When to choose
- you need programmatic zi wei dou shu chart generation in JavaScript/TypeScript
- you want a lightweight, MIT-licensed npm library with i18n support
- you're building an astrology frontend or API and need chart data, not just visuals

## When to avoid
- you need western astrology or other divination systems
- you want a ready-made chart UI rather than a data library
- you need the hosted AI interpretation models - those are separate paid API services, not part of this open-source package

## Facets
- artifact type: library
- maturity: active
- function: sdk, data-generation
- domain: developer-tools, cross-platform
- platform: -
- tags: astrology, ziweidoushu, purple-star-astrology, horoscope, natal-chart, astrolabe, chinese-astrology, multilingual, nodejs, typescript, javascript

## Member repositories
- SylarLong/iztro (main) score 94

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:34.666813+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:23:19.803653+00:00, confidence not recorded.
  - readme: https://github.com/SylarLong/iztro (fetched 2026-08-28T04:08:34.666813+00:00, sha 84fd7ac1c7c5)
  - registry_npm: https://registry.npmjs.org/iztro (fetched 2026-08-29T09:15:12.488289+00:00, sha 72e42a06a93a)
- Data as of 2026-08-30T08:39:29.467469+00:00.