# mumuy/relationship

中国亲戚关系计算器 - 家庭称谓/亲戚称呼/称呼计算/辈分计算/亲戚关系算法/親戚稱呼計算機_Chinese kinship system.

Repository: https://github.com/mumuy/relationship
Canonical: https://ross.abutalabs.com/products/relationship
Homepage: https://passer-by.com/relationship/
Language: JavaScript
License: MIT
License Family: permissive
Topics: kinship, relationship, chinese, family-tree
Last push: 2026-08-15T02:25:31+00:00

## Health v2 (maintenance only)
Score: 66/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 97, release rhythm 8, longevity 100
- inputs: {"age_days": 3822, "days_push": 19, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3727, forks 408 (observed 2026-08-28T04:08:15.673545+00:00)

## What it is
A JavaScript library and web app that computes Chinese family kinship terms and relationship chains, e.g. deriving the correct title for 'mother's mother's older brother'. It supports reverse lookup, pairwise relationship names, regional dialect modes, and natural-language-style queries.

## Use cases
- figure out what to call a distant relative like 七舅姥爷
- convert a kinship title back into its relationship chain
- find the collective term for two relatives such as 奶奶和外婆
- compute what a relative would call me (reverse addressing)
- support regional naming variants like Cantonese or northern Chinese titles
- parse natural language questions like '舅妈如何称呼外婆？'

## When to choose
- you need to compute or decode Chinese family titles in a browser or Node.js app
- you want reverse lookup, relationship chains, and pairwise terms in one small library
- you need customizable regional/dialect naming modes

## When to avoid
- you need kinship systems for cultures other than Chinese
- you need genealogy tree storage or family tree visualization rather than title computation
- you require guaranteed agreement with your local naming conventions, since regional variants may differ

## Facets
- artifact type: library
- maturity: active
- function: nlp, parser, developer-tools
- domain: developer-tools
- platform: browser
- tags: chinese-kinship, family-relationships, kinship-terminology, relationship-calculator, chinese-culture, natural-language-processing, localization, javascript, nodejs, web

## Member repositories
- mumuy/relationship (main) score 66

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:15.673545+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:29:15.399337+00:00, confidence not recorded.
  - readme: https://github.com/mumuy/relationship (fetched 2026-08-28T04:08:15.673545+00:00, sha e81852e341e9)
  - homepage: https://passer-by.com/relationship/ (fetched 2026-08-29T09:24:12.434779+00:00, sha df2db2db11b7)
  - site_page: https://passer-by.com/about.html (fetched 2026-08-29T09:24:12.443926+00:00, sha 53b4769d67d3)
- Data as of 2026-08-30T08:39:29.467469+00:00.