explaingit

houraiji/genshin-lore-graph

★ 11PythonAudience · researcherComplexity · 2/5LicenseSetup · easy

TLDR

A structured dataset of Genshin Impact characters, factions, gods, and world lore stored as queryable JSONL and JSON graph files so AI tools and programs can look up character relationships and game lore quickly.

Mindmap

mindmap
  root((genshin-lore-graph))
    Character Graph
      613 nodes
      585 relationships
      Family and rivals
      Factions and alliances
    Worldview Graph
      135 nodes
      Cosmology tree
      Power hierarchy
      Regions and races
    Data Formats
      JSONL records
      JSON adjacency table
      Name and alias index
    AI Integration
      Claude Code skill
      Codex skill
      Query scripts
    Caveats
      Directional edges
      Some speculation marked
      Not official HoYoverse
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Query the graph to find all known allies, rivals, and family connections for a specific Genshin Impact character.

USE CASE 2

Install the included AI assistant skill so Claude Code can answer lore questions directly from the local dataset.

USE CASE 3

Build a fan chatbot that answers questions about Genshin Impact lore using the structured graph as a retrieval layer.

USE CASE 4

Traverse the worldview tree to understand the cosmological power hierarchy from a concept down to its root.

Tech stack

PythonJSONLJSON

Getting it running

Difficulty · easy Time to first run · 30min

Data files are flat JSONL and JSON, no database required, but the AI skill install adds a dependency on Claude Code or Codex.

Non-commercial research use only, not affiliated with HoYoverse or miHoYo, intended for fan research and AI retrieval experiments.

In plain English

Genshin Lore Graph is a structured dataset about the characters, organizations, gods, events, and world lore of the video game Genshin Impact. The data was organized from publicly shared relationship maps on a site called GraphLink, then converted into formats that are easier for AI tools and programs to read and search through. The dataset has two parts. The character and entity graph covers 613 nodes, including player characters, NPCs, factions, monsters, and in-world objects, connected by 585 directional relationships such as family ties, rivalries, alliances, and story events. The worldview graph covers 135 nodes that describe the game's cosmology and hierarchy, including regions, races, abilities, and power levels, connected by 134 relationships and also organized into a tree structure with paths from the root node down to each concept. The files are stored as JSONL (one record per line) and JSON adjacency tables so that programs can look up a character by name and quickly retrieve all their known connections without loading the entire dataset at once. An index file maps names and aliases to node IDs for fast lookups. The repository also includes a skill that can be installed into AI coding assistants like Claude Code or Codex. Once installed, the assistant can call query scripts to answer questions about character relationships or worldview hierarchies using the local data. A combined query script can also pull basic character info from an external game wiki and merge it with the local graph data. The project notes that graph edges are directional and that some entries are marked as speculation or unresolved plot threads, not confirmed lore. The data reflects the state of the source maps at the time of collection and may not match the latest game version. The repository is not affiliated with HoYoverse or miHoYo, and is intended for non-commercial research and AI retrieval experiments.

Copy-paste prompts

Prompt 1
Using the genshin-lore-graph JSONL files, write a Python script that takes a character name and returns all their known relationships with type labels.
Prompt 2
Help me build a simple question-answering bot using genshin-lore-graph data that can answer questions like Is Zhongli related to Rex Lapis.
Prompt 3
Show me how to traverse the worldview graph tree from root to a specific concept like Gnosis and print the full path.
Prompt 4
Write a Python script that loads the genshin-lore-graph index file and searches for characters by alias or alternate name.
Open on GitHub → Explain another repo

← houraiji on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.