{"id":23818,"library":"graphrag","title":"GraphRAG","description":"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.","status":"active","version":"3.0.9","language":"python","source_language":"en","source_url":"https://github.com/microsoft/graphrag","tags":["rag","graph","nlp","llm","microsoft"],"install":[{"cmd":"pip install graphrag","lang":"bash","label":"PyPI"}],"dependencies":[{"reason":"Used for LLM calls; must be pinned due to past compromise (CVE)","package":"litellm","optional":false}],"imports":[{"wrong":"from graphrag.index import Indexer","symbol":"Indexer","correct":"from graphrag.index import Indexer"}],"quickstart":{"code":"import os\nos.environ.pop(\"OPENAI_API_KEY\", None)  # placeholder; set your key via env var\nfrom graphrag.index import Indexer\nfrom graphrag.query import QueryEngine\n# Index documents (requires a data directory and config)\n# Run: graphrag init --force to create default config\nprint(\"GraphRAG ready\")","lang":"python","description":"Minimal import and setup for GraphRAG. Note: Full indexing requires a config file and data directory; run `graphrag init --force` first."},"warnings":[{"fix":"Update imports to match new package structure (e.g., graphrag.index, graphrag.query, graphrag.cache, etc.)","message":"v3.0.0 introduced a monorepo restructure: many import paths changed. Use `from graphrag.index` instead of `from graphrag`. Old imports will break.","severity":"breaking","affected_versions":">=3.0.0"},{"fix":"Use `from graphrag.query import QueryEngine`","message":"The `QueryEngine` from `graphrag.query_engine` has been moved to `graphrag.query`. The old path may be removed in a future release.","severity":"deprecated","affected_versions":">=3.0.0"},{"fix":"Keep litellm pinned via GraphRAG's requirements; do not override.","message":"The `litellm` dependency was compromised in the past; GraphRAG pins a specific safe version. Do not upgrade litellm independently.","severity":"gotcha","affected_versions":">=3.0.7"},{"fix":"Upgrade to v3.0.2+ for Python 3.13 compatibility.","message":"Python 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.","severity":"breaking","affected_versions":"<3.0.2, >=3.11"},{"fix":"Run `graphrag init --force` after upgrading to regenerate config.","message":"The `graphrag init --force` command is required to reinitialize config after upgrading to v3.0.0; otherwise configs may be incompatible.","severity":"gotcha","affected_versions":">=3.0.0"}],"env_vars":null,"search_vec":"'3.0.9':20 '3.11':27 '3.14':28 'augment':10 'base':7 'current':17 'frequent':22 'generat':11 'graph':6,30 'graph-bas':5 'graphrag':1,2 'llm':32 'microsoft':15,33 'nlp':31 'patch':23 'python':26 'rag':12,29 'releas':24 'requir':25 'retriev':9 'retrieval-aug':8 'system':13 'version':18","created_at":"2026-05-01T08:09:47.013781+00:00","updated_at":"2026-05-01T08:09:47.013781+00:00","problems":{"verify_error":"Traceback (most recent call last):\n  File \"<string>\", line 1, in <module>\nImportError: cannot import name 'Indexer' from 'graphrag.index' (/tmp/tmpp9tmjw40/venv/lib/python3.12/site-packages/graphrag/index/__init__.py)"},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"3.1.0","cli_name":"graphrag","cli_version":"Usage: graphrag [OPTIONS] COMMAND [ARGS]...","type":"library","homepage":"https://microsoft.github.io/graphrag/","github":"https://github.com/microsoft/graphrag","docs":null,"changelog":null,"pypi":"https://pypi.org/project/graphrag/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["llm-agents","ai-ml","data","vector-search"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"import_fail","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-07-10","install_tag":null}}