\r \r

genealogy-agent\r

\r A powerful agent skill for extracting, structuring, researching, and visualizing family history from raw text (memoirs, archives, chat logs).\r \r

Features\r

• LLM Extraction: Parses unstructured text to find people, dates, locations, and relationships.\r
• Knowledge Graph: Stores family data in a local JSONL ontology graph.\r
• Obsidian Vault Generation: Automatically generates an Obsidian-compatible vault (Markdown files with YAML frontmatter) for your family tree.\r
• Auto-Research: Autonomously searches global and regional databases (FamilySearch, Ancestry, OBD Memorial, Geneteka, etc.) to find new facts about ancestors.\r
• GEDCOM Export: Exports your family tree to the standard .ged format for use in MyHeritage, FamilySearch, or any desktop genealogy software.\r
• Mermaid Visualization: Automatically generates beautiful family tree diagrams.\r \r

Setup\r

1. Install dependencies: uv pip install pydantic litellm duckduckgo-search\r
2. Set your preferred LLM provider (e.g., OPENAI_API_KEY or GEMINI_API_KEY).\r \r

Usage\r

You can ask the agent to:\r

• "Extract family members from this text: [text]"\r
• "Build a family tree from the extracted data"\r
• "Research my great-grandfather Ivan Ivanov born in 1910"\r
• "Export my family tree to GEDCOM"\r
• "Generate an Obsidian vault from my family data"\r \r

Tools\r

• extract_family_data: Extracts structured family data (people, dates, relationships) from raw text using an LLM.\r
• build_family_graph: Saves extracted data into the local ontology graph.\r
• generate_mermaid_tree: Generates a Mermaid diagram from the graph.\r
• generate_obsidian_vault: Generates an Obsidian-formatted vault from extracted family data.\r
• research_ancestor: Autonomously researches an ancestor using web search and LLM extraction.\r
• export_gedcom: Exports extracted family data to a standard GEDCOM (.ged) file.