Using the Chat
What it's for: asking natural-language questions about your DNA data and seeing — and
verifying — exactly what the AI receives.
The window
- Top bar: the database path box and … / Open
buttons; the backend and model pickers (with ↻ to
refresh models); the privacy badge; and the Privacy & Debug toggle.
- Privacy badge: Pseudonymized (green) when identities are tokenized, or
REAL NAMES (local only) (orange) when you've enabled real-names mode with a local AI.
- Chat area: your messages, the AI's answers, and grey tool-call lines showing
which data tool the AI used (e.g.
⏵ get_matches …).
- Input row: the “ask about your matches…” box and
Send (Enter also sends).
- Status line: shows progress — e.g. “done · in 900 / out 1,200
tokens” after each answer.
Reading answers
Names in the AI's reply that DGAI restored from tokens are
highlighted. Hover a
reply to see a “Restored locally:” list mapping each token to the real name it
became — your proof of what actually went to the AI.
📷 Screenshot: The chat with a tool-call line, a highlighted restored name, and the hover tooltip.
The Privacy & Debug panel
Click Privacy & Debug to open a side panel with three tabs:
- What the AI sees — the exact outbound payloads (newest first). Everything here is
tokenized; this is all the AI ever receives. Great for reassurance and for the curious.
- Token lookup — type any token (e.g.
[M1234]) and click
Reveal to translate it to the real value, locally. Unknown tokens report that they were
never minted for this database.
- Settings — API key and endpoint, plus the two opt-ins: Send research
notes / free text to cloud AI and Real names (localhost AI only). Changes apply
the next time you press Open.
What you can ask
Behind the scenes the AI has a set of tools for your data — matches, shared matches, segments,
chromosome overlap, ancestor trees, surname/place search, common ancestors, and ancestral hubs. That means
you can ask things like:
- Overview: “Summarize this database and list my profiles.”
- Matches: “My top 15 matches over 100 cM, and their side (maternal/paternal).”
- Shared matches: “Who is in common with both [M1234] and [M5678]?”
- Segments & triangulation: “Which matches overlap chromosome 7 between 20 and
40 Mbp?”
- Trees: “Which matches have the surname Hart in Ohio before 1880?”
- Common ancestors: “What common ancestors do I share with my closest match?”
You can refer to relatives by name (“Mary’s brother”) — DGAI resolves
the name to a token locally before sending. You'll see the substitution noted in the chat.