graphrag

library3.1.0pypypiunverified

GraphRAG is a graph-based retrieval-augmented generation (RAG) system by Microsoft. The current version is 3.0.9, with frequent patch releases. Requires Python >=3.11, <3.14.

llm-agents ai-ml data vector-search

pip install graphrag

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · GRAPHRAG

graphrag

llm-agentspythonv3.1.0

Install

46.0s avg

Import

—

Disk

1254MB

Pass rate

4/ 10

Env Coverage4 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2.7.2 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

glibc

py 3.10

✕ build_error

✓ 57.1s

py 3.11

✕ build_error

✓ 46.5s

py 3.12

✕ build_error

✓ 39.9s

py 3.13

✕ build_error

✓ 40.3s

py 3.9

✕ build_error

1254MB installed

● package 1254MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Indexer

✓ from graphrag.index import Indexer

✗ from graphrag.index import Indexer

Minimal import and setup for GraphRAG. Note: Full indexing requires a config file and data directory; run `graphrag init --force` first.

import os os.environ.pop("OPENAI_API_KEY", None) # placeholder; set your key via env var from graphrag.index import Indexer from graphrag.query import QueryEngine # Index documents (requires a data directory and config) # Run: graphrag init --force to create default config print("GraphRAG ready")

graphrag --version

Debug

Known issues

breakingv3.0.0 introduced a monorepo restructure: many import paths changed. Use `from graphrag.index` instead of `from graphrag`. Old imports will break.

fix

Update imports to match new package structure (e.g., graphrag.index, graphrag.query, graphrag.cache, etc.)

affects: >=3.0.0

deprecatedThe `QueryEngine` from `graphrag.query_engine` has been moved to `graphrag.query`. The old path may be removed in a future release.

fix

Use `from graphrag.query import QueryEngine`

affects: >=3.0.0

gotchaThe `litellm` dependency was compromised in the past; GraphRAG pins a specific safe version. Do not upgrade litellm independently.

fix

Keep litellm pinned via GraphRAG's requirements; do not override.

affects: >=3.0.7

breakingPython 3.13 support was added in v3.0.2, but v3.0.0-v3.0.1 did not support it. Python 3.11 is the minimum.

fix

Upgrade to v3.0.2+ for Python 3.13 compatibility.

affects: <3.0.2, >=3.11

gotchaThe `graphrag init --force` command is required to reinitialize config after upgrading to v3.0.0; otherwise configs may be incompatible.

fix

Run `graphrag init --force` after upgrading to regenerate config.

affects: >=3.0.0

Upgrade

Version history

3.1.0latest on PyPI · released May 28, 2026

Audit

Dependencies

litellmrequiredUsed for LLM calls; must be pinned due to past compromise (CVE)

Agent activity

91 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/microsoft/graphrag ↗

packagehttps://pypi.org/project/graphrag/ ↗

homepagehttps://microsoft.github.io/graphrag/ ↗