---
id: graphrag
version: "3.1.1"
license: MIT
license_treatment: permissive
maintenance: active
---

# graphrag — GraphRAG: A graph-based retrieval-augmented generation (RAG) system.

License: permissive · Maintenance: active · Downloads: 85.1K/mo

## What it is and what it does

GraphRAG is a data pipeline and transformation suite from Microsoft Research that converts unstructured narrative text into structured knowledge graphs using LLM reasoning. It is designed to enhance retrieval-augmented generation (RAG) systems by giving LLMs a memory structure—a graph of entities and relationships—that helps them reason more accurately over private or domain-specific data.

The system takes raw text as input, uses LLMs to extract entities, relationships, and hierarchical summaries, and builds a queryable knowledge graph. This graph can then be queried to retrieve relevant context for LLM prompts, improving answer quality and reasoning over complex documents. The package includes a command-line interface and Python API, depends on Azure cloud services for some deployments, and requires careful tuning of prompts and configuration for best results. The documentation warns that indexing can be costly and recommends starting small and reading the full documentation before large-scale use.

Use it for:

- Extract structured knowledge from large document collections (research papers, internal wikis, legal contracts) to enable semantic search and reasoning.
- Build a queryable entity-relationship graph from narrative text to support question-answering systems over private data.
- Enhance RAG systems with hierarchical summaries and relationship context to improve LLM reasoning on complex multi-document queries.
- Organize and index domain-specific corpora (medical records, technical documentation, news archives) for downstream LLM applications.
- Prototype knowledge graph construction pipelines where LLM-driven extraction replaces manual annotation.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

GraphRAG extracts structured knowledge graphs from unstructured text using LLMs, enabling retrieval-augmented generation (RAG) systems to reason more effectively over private data.

Yes, if you need to build a graph-based RAG system over unstructured text and are willing to invest in prompt tuning and cost management. The package is actively maintained, has no known vulnerabilities, and is backed by Microsoft Research. The 25 dependencies and indexing costs are real trade-offs; start with the documentation and a small dataset to validate the approach before scaling. Not recommended if you need a lightweight, zero-configuration RAG solution.

## Install

pip install graphrag
uv add graphrag
poetry add graphrag

## Installing graphrag

Before you install: Low friction install with a pure-Python wheel. Active maintenance (last commit 2026-08-14, 27 days since release). Requires 25 runtime dependencies including Azure cloud SDKs, NLP libraries (spacy, nltk), and data processing tools (pandas, networkx); this is a substantial dependency footprint but all are established packages.

License in practice: MIT license permits commercial and private use with minimal restrictions—you may use, modify, and distribute GraphRAG freely provided you include the license notice.

Quickstart:

pip install graphrag

from graphrag.index import run_pipeline_async
import asyncio

await run_pipeline_async(root_dir="./your_data")

Requires Python 3.11 or later (supports 3.11, 3.12, 3.13). Indexing operations can be expensive; review documentation on costs and start with small datasets. Azure credentials may be needed depending on your storage and LLM provider configuration.

Verify before relying:

- Whether the 25 runtime dependencies are all required for basic usage or if some are optional for specific features.
- Specific LLM provider integrations supported beyond Azure (e.g., OpenAI, local models).
- Performance characteristics and typical indexing time/cost for datasets of different sizes.
- Whether prompt tuning is mandatory for acceptable results on typical datasets or optional for refinement.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 85.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

knowledge graph extraction from text, llm-powered rag system, structured data from unstructured text, graph-based retrieval augmented generation, knowledge graph memory for llms, semantic data pipeline, text to knowledge graph, knowledge-graph, rag-system, llm-pipeline

[View on SkillFed](https://skillfed.io/packages/graphrag) · [View on PyPI](https://pypi.org/project/graphrag/)