genealogy-agent
A powerful agent skill for extracting, structuring, researching, and visualizing family history from raw text (memoirs, archives, chat logs).
Features
- LLM Extraction: Parses unstructured text to find people, dates, locations, and relationships.
- Knowledge Graph: Stores family data in a local JSONL ontology graph.
- Obsidian Vault Generation: Automatically generates an Obsidian-compatible vault (Markdown files with YAML frontmatter) for your family tree.
- Auto-Research: Autonomously searches global and regional databases (FamilySearch, Ancestry, OBD Memorial, Geneteka, etc.) to find new facts about ancestors.
- GEDCOM Export: Exports your family tree to the standard
.ged format for use in MyHeritage, FamilySearch, or any desktop genealogy software.
- Mermaid Visualization: Automatically generates beautiful family tree diagrams.
Setup
- Install dependencies:
uv pip install pydantic litellm duckduckgo-search
- Set your preferred LLM provider (e.g.,
OPENAI_API_KEY or GEMINI_API_KEY).
Usage
You can ask the agent to:
- "Extract family members from this text: [text]"
- "Build a family tree from the extracted data"
- "Research my great-grandfather Ivan Ivanov born in 1910"
- "Export my family tree to GEDCOM"
- "Generate an Obsidian vault from my family data"
Tools
extract_family_data: Extracts structured family data (people, dates, relationships) from raw text using an LLM.
build_family_graph: Saves extracted data into the local ontology graph.
generate_mermaid_tree: Generates a Mermaid diagram from the graph.
generate_obsidian_vault: Generates an Obsidian-formatted vault from extracted family data.
research_ancestor: Autonomously researches an ancestor using web search and LLM extraction.
export_gedcom: Exports extracted family data to a standard GEDCOM (.ged) file.