Skip to content

feat(demo-got): add Game of Thrones family tree HelixDB demo - #3

Merged
kevinmichaelchen merged 3 commits into
mainfrom
feat/demo-got
Jan 17, 2026
Merged

feat(demo-got): add Game of Thrones family tree HelixDB demo#3
kevinmichaelchen merged 3 commits into
mainfrom
feat/demo-got

Conversation

@kevinmichaelchen

Copy link
Copy Markdown
Owner

Summary

  • Add new demo-got crate demonstrating HelixDB graph capabilities
  • Uses Game of Thrones family relationships (30 characters, 88 edges)
  • CLI with ingest and query commands
  • Showcases graph traversal (ancestors, descendants, house members)

Features

# Ingest family tree into HelixDB
cargo run -p demo-got -- ingest

# Query Jon Snow's ancestors (reveals R+L=J!)
cargo run -p demo-got -- query ancestors jon-snow

# Query Ned Stark's descendants  
cargo run -p demo-got -- query descendants ned-stark

# Query House Stark members
cargo run -p demo-got -- query house stark

# Get person details with family
cargo run -p demo-got -- query person ned-stark

# JSON output
cargo run -p demo-got -- --json query ancestors jon-snow

Test plan

  • cargo fmt --check passes
  • cargo clippy -D warnings passes
  • cargo test -p demo-got passes (2 tests)
  • cargo run -p demo-got -- ingest creates database with 30 nodes, 88 edges
  • cargo run -p demo-got -- query ancestors jon-snow shows correct lineage
  • Database persists across process restarts

Add a new demo crate that showcases HelixDB graph capabilities using
Game of Thrones family relationships. The CLI supports ingesting family
tree data from YAML and querying ancestor/descendant relationships.

Features:
- Ingest 30 characters from Houses Stark, Targaryen, Baratheon, Tully
- Query ancestors (e.g., Jon Snow's lineage reveals R+L=J)
- Query descendants, house members, person details
- JSON output support
- Persistent storage in .demo-got/graph.db/
Move database storage from repo-root `.demo-got/` to crate-local
`demo-got/.data/` for better organization. Use a nested .gitignore
to keep the database files excluded.
@kevinmichaelchen
kevinmichaelchen merged commit 2d5dedf into main Jan 17, 2026
6 checks passed
@kevinmichaelchen
kevinmichaelchen deleted the feat/demo-got branch January 17, 2026 16:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant