{"id":24987776,"url":"https://github.com/datastax/graph-rag","last_synced_at":"2025-11-11T18:07:08.727Z","repository":{"id":275192044,"uuid":"913763726","full_name":"datastax/graph-rag","owner":"datastax","description":"Graph traversal for improved RAG","archived":false,"fork":false,"pushed_at":"2025-04-10T15:34:24.000Z","size":2811,"stargazers_count":27,"open_issues_count":7,"forks_count":3,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-04-11T23:51:50.508Z","etag":null,"topics":["genai","langchain","langchain-python","rag","retrieval-augmented-generation"],"latest_commit_sha":null,"homepage":"https://datastax.github.io/graph-rag/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/datastax.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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,"zenodo":null}},"created_at":"2025-01-08T10:01:13.000Z","updated_at":"2025-04-11T19:23:54.000Z","dependencies_parsed_at":null,"dependency_job_id":"9b17df12-00ad-4b92-b21c-eb26b7bc87ff","html_url":"https://github.com/datastax/graph-rag","commit_stats":null,"previous_names":["datastax/graph-rag"],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datastax%2Fgraph-rag","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datastax%2Fgraph-rag/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datastax%2Fgraph-rag/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datastax%2Fgraph-rag/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/datastax","download_url":"https://codeload.github.com/datastax/graph-rag/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248497864,"owners_count":21113984,"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":["genai","langchain","langchain-python","rag","retrieval-augmented-generation"],"created_at":"2025-02-04T11:55:54.810Z","updated_at":"2025-11-11T18:07:08.691Z","avatar_url":"https://github.com/datastax.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Graph RAG\n\nRetrievers providing both **unstructured** (similarity-search on vectors) and\n**structured** (traversal of metadata properties).\n\n\n\u003c!-- Improved compatibility of back to top link: See: https://github.com/othneildrew/Best-README-Template/pull/73 --\u003e\n\u003ca id=\"readme-top\"\u003e\u003c/a\u003e\n\n\u003c!-- PROJECT SHIELDS --\u003e\n\u003c!--\n*** I'm using markdown \"reference style\" links for readability.\n*** Reference links are enclosed in brackets [ ] instead of parentheses ( ).\n*** See the bottom of this document for the declaration of the reference variables\n*** for contributors-url, forks-url, etc. This is an optional, concise syntax you may use.\n*** https://www.markdownguide.org/basic-syntax/#reference-style-links\n--\u003e\n[![Status][status-shield]][status-url]\n[![Coverage][coverage-shield]][coverage-url]\n[![Contributors][contributors-shield]][contributors-url]\n[![Forks][forks-shield]][forks-url]\n[![Stargazers][stars-shield]][stars-url]\n[![Issues][issues-shield]][issues-url]\n[![License][license-shield]][license-url]\n\n\n\u003c!-- PROJECT LOGO --\u003e\n\u003cbr /\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/datastax/graph-rag\"\u003e\n    \u003cimg src=\"https://github.com/datastax/graph-rag/raw/main/images/logo.jpg\" alt=\"Logo\" height=\"160px\"\u003e\n  \u003c/a\u003e\n\n\u003ch3 align=\"center\"\u003eGraph RAG - Combining Vector and Graph for better RAG\u003c/h3\u003e\n\n  \u003cp align=\"center\"\u003e\n    Library providing Graph RAG combining vector search and traversal of metadata relationships.\n    \u003cbr /\u003e\n    \u003ca href=\"https://datastax.github.io/graph-rag\"\u003e\u003cstrong\u003eExplore the docs »\u003c/strong\u003e\u003c/a\u003e --\u003e\n    \u003cbr /\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/datastax/graph-rag/issues\"\u003eReport Bug\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/datastax/graph-rag/issues\"\u003eRequest Feature\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\n\n\u003c!-- TABLE OF CONTENTS --\u003e\n\u003cdetails\u003e\n  \u003csummary\u003eTable of Contents\u003c/summary\u003e\n  \u003col\u003e\n    \u003cli\u003e\u003ca href=\"#about-the-project\"\u003eAbout The Project\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#getting-started-with-langchain\"\u003eGetting Started with LangChain\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#roadmap\"\u003eRoadmap\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#contributing\"\u003eContributing\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#license\"\u003eLicense\u003c/a\u003e\u003c/li\u003e\n  \u003c/ol\u003e\n\u003c/details\u003e\n\n\n\n\u003c!-- ABOUT THE PROJECT --\u003e\n## About The Project\n\nGraph RAG provides retrievers combining vector-search (for unstructured similarity) and traversal (for structured relationships in metadata).\nThese retrievers are implemented using the metadata search functionality of existing vector stores, **allowing you to traverse your existing vector store**!\n\nThe core library (`graph-retriever`) supports can be used in generic Python applications, while `langchain-graph-retriever` provides [langchain](https://python.langchain.com/docs/introduction/)-specific functionality.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\u003c!-- GETTING STARTED --\u003e\n## Getting Started with LangChain\n\n1. Install `langchain-graph-retriever` (or add to your Python dependencies).\n\n    ```sh\n    pip install langchain-graph-retriever\n    ```\n\n1. Wrap your existing vector store to enable graph retrieval:\n\n    ```python\n    from langchain_graph_retriever import GraphRetriever\n\n    retriever = GraphRetriever(\n        # Adapt AstraDBVectorStore for use with Graph Retrievers.\n        # Exposes functionality of the underlying store that is otherwise not available.\n        store = store,\n        # Define the relationships to navigate:\n        #   1. From nodes with a list of `mentions` to the nodes with the corresponding `ids`.\n        #   2. From nodes with a list of related `entities` to other nodes with the same entities.\n        edges = [(\"mentions\", \"id\"), \"entities\"],\n    )\n\n    retriever.invoke(\"where is Santa Clara?\")\n    ```\n\n## Roadmap\n\nGraph RAG is under active development.\nThis is an overview of our current roadmap - please 👍 issues that are important to you.\nDon't see a feature that would be helpful for your application - [create a feature request](https://github.com/datastax/graph-rag/issues)!\n\n* Support more vector stores\n* Support [Lazy Graph RAG](https://www.microsoft.com/en-us/research/blog/lazygraphrag-setting-a-new-standard-for-quality-and-cost/) on the retrieved\n  documents.\n\n\u003c!-- CONTRIBUTING --\u003e\n## Contributing\n\nContributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.\n\nIf you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag \"enhancement\".\nDon't forget to give the project a star! Thanks again!\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\nSee [CONTRIBUTING.md](`CONTRIBUTING.md`) for more information on development.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\n\n\u003c!-- LICENSE --\u003e\n## License\n\nDistributed under the Apache 2 License. See `LICENSE.txt` for more information.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n[coverage-shield]: https://img.shields.io/coverallsCoverage/github/datastax/graph-rag?style=for-the-badge\n[coverage-url]: https://coveralls.io/github/datastax/graph-rag\n[status-shield]: https://img.shields.io/github/check-runs/datastax/graph-rag/main?style=for-the-badge\n[status-url]: https://github.com/datastax/graph-rag/actions/workflows/main.yml?query=branch%3Amain\n[contributors-shield]: https://img.shields.io/github/contributors/datastax/graph-rag.svg?style=for-the-badge\n[contributors-url]: https://github.com/datastax/graph-rag/graphs/contributors\n[forks-shield]: https://img.shields.io/github/forks/datastax/graph-rag.svg?style=for-the-badge\n[forks-url]: https://github.com/datastax/graph-rag/network/members\n[stars-shield]: https://img.shields.io/github/stars/datastax/graph-rag.svg?style=for-the-badge\n[stars-url]: https://github.com/datastax/graph-rag/stargazers\n[issues-shield]: https://img.shields.io/github/issues/datastax/graph-rag.svg?style=for-the-badge\n[issues-url]: https://github.com/datastax/graph-rag/issues\n[license-shield]: https://img.shields.io/github/license/datastax/graph-rag.svg?style=for-the-badge\n[license-url]: https://github.com/datastax/graph-rag/blob/master/LICENSE.txt\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatastax%2Fgraph-rag","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdatastax%2Fgraph-rag","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatastax%2Fgraph-rag/lists"}