Skip to content
ExtantApePublic

About

OneLineage: DNA-first genetic genealogy for Mac. Groups your matches before your tree can bias them, and gives odds on every family-tree hypothesis. Runs locally, no servers.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

OneFamily

DNA-first genetic genealogy for Mac. OneFamily groups your DNA matches before your family tree can bias them, then gives odds on each possible family tree. It runs on your own Mac, with no servers and no account.

Status: early, and only tested on made-up families; nothing reads real data yet. Built so far:

  • the design (docs/architecture/) and the use policy
  • the terms register (terms/, read 2026-11-10), and the code that enforces it
  • a simulator of made-up families with planted answers
  • importers for Genealogy Assistant-style match lists you export yourself (allowed by the owner's reading of the terms, pending a legal review), and for raw DNA in five companies' layouts
  • match grouping from the DNA alone (ADR 0006)
  • kit-to-kit comparison, triangulation and segment painting, with an approximate map or the GRCh37 map the app downloads after a yes
  • sibling phasing, half-kits and rebuilt relatives (made-up data only)
  • the hypothesis engine with odds (ADR 0008)
  • the library with checked, encrypted backups
  • one universal ID per person, and proposed cross-service links
  • OneFamily for Mac, v0: runs on a made-up demo family. It's been built and opened locally, not released. It carries its own copy of Node, so nothing extra needs installing (ADR 0007).
  • the Chrome extension the app collects with (apps/extension, ADR 0009). It stores nothing, talks to the app only through Chrome's native messaging, and asks for your OK in the app. It only works with a local mock site: every DNA service's terms say no to automated page visits. It's been tested with Vitest against the mock site, and hasn't been loaded into Chrome yet.

282 tests pass locally. On 2026-11-15 the match importer and grouping reproduced a real finished family run (groups ARI 0.98, sides identical), outside the repo. The raw layouts haven't been checked against a real downloaded file. The register's verdicts are a careful reading of public pages, not legal advice, and a legal review is still to come.

What it will do

  • Collect your matches from the testing services you use, as far as each service's terms allow.
  • Group them from the DNA alone, with your tree kept out until you choose to unblind.
  • Check for misattributed parents and half relationships, and place small matches.
  • Build possible family trees with odds, and track your working theories against the evidence.
  • Keep everything as plain files in a folder you choose, with backups to two places by default.

It's part of the OneOrigin family. Family trees are drawn with OnePedigree's views.

Who may use it

See USE-POLICY.md. It's for family research, your own or someone else's. Law-enforcement use isn't allowed, except through an appropriately sanctioned lab.

Build

pnpm install
pnpm test

A pnpm workspace: Node 22 or later, TypeScript, Vitest.

Commands

# The Mac app in development (needs Rust; the first run downloads the app's own Node from nodejs.org and checks it)
pnpm --filter onefamily-desktop app:dev

# The same screens in a browser, without the Mac shell
pnpm --filter onefamily-desktop dev

# The Chrome extension, built into apps/extension/dist (load it unpacked from chrome://extensions)
pnpm --filter onefamily-extension build

# The made-up genealogy site the extension is tested against, on 127.0.0.1:8787
pnpm --filter onefamily-extension mock-site

# Chrome's native messaging host for a developer build you've trusted in the app. Writes two files in your
# Library folder; add --dry-run to see them first
pnpm --filter onefamily-desktop build:host
node apps/desktop/host-dist/install-native-host.mjs --extension-id <id from chrome://extensions>

# A made-up family with planted answers, written as Genealogy Assistant-style CSVs plus truth.json
pnpm --filter @extantape/onefamily-simulate simulate --seed 1 --out ../../fixtures/generated/planted-1

The simulator's limits: crossovers have no interference, matches below 8 cM and segments below 7 cM are dropped, and there's no Timber-style weighting. Weighted and unweighted cM are therefore equal, and segment lengths come from a rounded genetic map. Every name and ID is invented.

License

Source-available under the PolyForm Noncommercial License 1.0.0, with the use restriction in its Required Notice. This license doesn't make it open source.

About

OneLineage: DNA-first genetic genealogy for Mac. Groups your matches before your tree can bias them, and gives odds on every family-tree hypothesis. Runs locally, no servers.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages