AncestryLLM is a local-first platform for genealogy research tools. It combines deterministic RootsMagic and GEDCOM workflows with optional, explicitly selected LLM providers. The CLI and its interactive console are the only supported product surfaces in the 0.2.0 release. The accepted local Electron and private FastAPI desktop architecture remains unshipped and is not a public API.
Python 3.12 through 3.14 and a working OS credential store are required. Install the isolated command with pipx:
pipx install ancestryllm
ancestry --version
ancestry --helpInstall every optional LLM provider with
pipx install 'ancestryllm[all-llm]'. Remote providers are never selected from
installed packages or environment keys: every cloud call still requires an
explicit profile and consent.
Run ancestry with no arguments for the prompt-toolkit/Rich interactive
console. It is the only supported interactive console; the
prompt stays responsive while background operations render live, sanitized
spinner or completed-unit progress above it. One-shot and JSON output never
emit terminal animation. The canonical command reference, examples, offline
defaults, and privacy rules are
in the CLI guide;
see the console guide
for interactive use.
rootsmagic: immutable, bounded SELECT/CTE queries and deterministic GEDCOM export.gedcom: merge, rooted subtree, quality analysis, incremental update, and rebase.prompts: immutable prompt revisions with declared variables and output schemas.people: curated research people, identifiers, facts, links, and provenance.providers: explicit Ollama, OpenAI, Anthropic, Gemini, and OpenRouter profiles.ocr: schema-validated extraction through the same provider boundary.secrets: no-echo OS-keyring management; values never appear in status output.
git clone https://github.com/sodejm/AncestryLLM.git
cd AncestryLLM
make setup
make test
make lint
make typecheck
make security
make sbommake setup creates .venv and installs the checkout in editable mode with
locked development and provider dependencies. The equivalent manual command is
.venv/bin/pip install --editable '.[all-llm,dev]'; it is for contributors,
not end-user installation.
The dependency graph is locked in uv.lock. Never commit real family trees,
GEDCOM exports, databases, logs, reports, secrets, or research-person data.
Read the architecture, desktop ADR, CLI guide, privacy and consent, provider guide, GEDCOM compatibility, encrypted backups, and threat model.
Versioning follows Semantic Versioning 2.0.0. The versioning policy defines the CLI contracts covered by a release.
Automated round-trip and preservation tests run in CI. Ancestry, Geni, and MyHeritage imports must still be manually smoke-tested for each release; this repository does not claim production interoperability until that checklist is completed and recorded.