{"id":17527095,"url":"https://github.com/noworneverev/graphrag-visualizer","last_synced_at":"2025-03-06T06:31:38.416Z","repository":{"id":252134189,"uuid":"839050055","full_name":"noworneverev/graphrag-visualizer","owner":"noworneverev","description":"A web-based tool for visualizing and exploring artifacts from Microsoft's GraphRAG.","archived":false,"fork":false,"pushed_at":"2024-12-27T09:22:19.000Z","size":20650,"stargazers_count":292,"open_issues_count":2,"forks_count":33,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-03-01T09:40:04.233Z","etag":null,"topics":["gpt","gpt-4","gpt4","graph-visualization","graphrag","llm","llms","rag"],"latest_commit_sha":null,"homepage":"https://noworneverev.github.io/graphrag-visualizer/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/noworneverev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-06T21:34:40.000Z","updated_at":"2025-02-28T08:40:56.000Z","dependencies_parsed_at":"2024-12-27T10:21:41.510Z","dependency_job_id":"d0b966e5-af91-4040-a718-d90ed2224e34","html_url":"https://github.com/noworneverev/graphrag-visualizer","commit_stats":null,"previous_names":["noworneverev/graphrag-visualizer"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noworneverev%2Fgraphrag-visualizer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noworneverev%2Fgraphrag-visualizer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noworneverev%2Fgraphrag-visualizer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noworneverev%2Fgraphrag-visualizer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/noworneverev","download_url":"https://codeload.github.com/noworneverev/graphrag-visualizer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242161807,"owners_count":20081946,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gpt","gpt-4","gpt4","graph-visualization","graphrag","llm","llms","rag"],"created_at":"2024-10-20T15:03:09.493Z","updated_at":"2025-03-06T06:31:38.402Z","avatar_url":"https://github.com/noworneverev.png","language":"TypeScript","funding_links":[],"categories":["A01_文本生成_文本对话","TypeScript","Building","GraphRAG"],"sub_categories":["大语言对话模型及数据","Tools","GraphRAG-Related Projects"],"readme":"# GraphRAG Visualizer\n\n👉 [GraphRAG Visualizer](https://noworneverev.github.io/graphrag-visualizer/)\u003cbr/\u003e\n👉 [GraphRAG Visualizer Demo](https://www.youtube.com/watch?v=Hjx1iTZZtzw)\n\n![demo](public/demo.png)\n\n## Overview\n\nGraphRAG Visualizer is an application designed to visualize Microsoft [GraphRAG](https://github.com/microsoft/graphrag) artifacts. By uploading parquet files generated from the GraphRAG indexing pipeline, users can easily view and analyze data without needing additional software or scripts.\n\n## Important Note\n\nIf you are using **GraphRAG 0.3.x or below**, please use the legacy version of GraphRAG Visualizer available at:  \n👉 [GraphRAG Visualizer Legacy](https://noworneverev.github.io/graphrag-visualizer-legacy)\n\n## Features\n\n- **Graph Visualization**: View the graph in 2D or 3D in the \"Graph Visualization\" tab.\n- **Data Tables**: Display data from the parquet files in the \"Data Tables\" tab.\n- **Search Functionality**: Fully supports search, allowing users to focus on specific nodes or relationships.\n- **Local Processing**: All artifacts are processed locally on your machine, ensuring data security and privacy.\n\n## Using the Search Functionality\n\nOnce the [graphrag-api](https://github.com/noworneverev/graphrag-api) server is up and running, you can perform searches directly through the GraphRAG Visualizer. Simply go to the [GraphRAG Visualizer](https://noworneverev.github.io/graphrag-visualizer/) and use the search interface to query the API server. This allows you to easily search and explore data that is hosted on your local server.\n\n![search](public/search.png)\n\n## Graph Data Model\n\nThe logic for creating relationships for text units, documents, communities, and covariates is derived from the [GraphRAG import Neo4j Cypher notebook](https://github.com/microsoft/graphrag/blob/main/examples_notebooks/community_contrib/neo4j/graphrag_import_neo4j_cypher.ipynb).\n\n### Nodes\n\n| Node      | Type           |\n| --------- | -------------- |\n| Document  | `RAW_DOCUMENT` |\n| Text Unit | `CHUNK`        |\n| Community | `COMMUNITY`    |\n| Finding   | `FINDING`      |\n| Covariate | `COVARIATE`    |\n| Entity    | _Varies_       |\n\n### Relationships\n\n| Source Node | Relationship    | Target Node |\n| ----------- | --------------- | ----------- |\n| Entity      | `RELATED`       | Entity      |\n| Text Unit   | `PART_OF`       | Document    |\n| Text Unit   | `HAS_ENTITY`    | Entity      |\n| Text Unit   | `HAS_COVARIATE` | Covariate   |\n| Community   | `HAS_FINDING`   | Finding     |\n| Entity      | `IN_COMMUNITY`  | Community   |\n\n## Developer Instructions\n\n### Setting Up the Project\n\n1. Clone the repository to your local machine:\n\n   ```bash\n   git clone https://github.com/noworneverev/graphrag-visualizer.git\n   cd graphrag-visualizer\n   ```\n\n2. Install the necessary dependencies:\n\n   ```bash\n   npm install\n   ```\n\n3. Run the development server:\n\n   ```bash\n   npm start\n   ```\n\n4. Open the app in your browser:\n   ```\n   http://localhost:3000\n   ```\n\n### Loading Parquet Files\n\nTo load `.parquet` files automatically when the application starts, place your Parquet files in the `public/artifacts` directory. These files will be loaded into the application for visualization and data table display. The files can be organized as follows:\n\n- `public/artifacts/create_final_entities.parquet`\n- `public/artifacts/create_final_relationships.parquet`\n- `public/artifacts/create_final_documents.parquet`\n- `public/artifacts/create_final_text_units.parquet`\n- `public/artifacts/create_final_communities.parquet`\n- `public/artifacts/create_final_community_reports.parquet`\n- `public/artifacts/create_final_covariates.parquet`\n\nIf the files are placed in the `public/artifacts` folder, the app will automatically load and display them on startup.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnoworneverev%2Fgraphrag-visualizer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnoworneverev%2Fgraphrag-visualizer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnoworneverev%2Fgraphrag-visualizer/lists"}