Change8

GraphRAG

AI & LLMs

A modular graph-based Retrieval-Augmented Generation (RAG) system

Latest: v3.0.415 releases4 breaking changes11 common errorsView on GitHub

Release History

v3.0.41 fix8 features
Feb 24, 2026

This release introduces significant streaming capabilities across several core document and graph processing steps, alongside bug fixes and enhancements to vector operations.

v3.0.2Breaking2 fixes6 features
Feb 13, 2026

This patch introduces significant enhancements to data handling with new TableProvider abstractions, CSV support, and asynchronous reading capabilities. It also removes the NetworkX dependency from graph utilities.

v3.0.11 fix
Jan 28, 2026

This patch release addresses a missing dependency issue.

v3.0.0Breaking1 feature
Jan 28, 2026

This major release introduces a significant monorepo restructure, splitting the codebase into several new dedicated packages and requiring users to reinitialize their configuration.

v2.7.1
Jan 26, 2026

This patch release pins the pandas dependency to version 2.3.3 for stability.

v2.7.01 fix1 feature
Oct 9, 2025

This release sets LiteLLM as the default for content initialization and resolves an Azure authentication scope issue when LiteLLM is used.

v2.6.04 fixes5 features
Sep 22, 2025

This release introduces support for LiteLLM providers, adds new configuration options for NLP and vector stores, and includes several bug fixes, notably correcting 0-based indexing for human_readable_id fields.

v.2.5.01 feature
Aug 14, 2025

This release introduces an enhancement to the build index signature by adding an additional context variable and migrates the internal package management from Poetry to UV.

v.2.4.03 fixes2 features
Jul 15, 2025

This release introduces the ability to inject custom pipelines and refactors the StorageFactory using a registration-based approach, alongside several minor fixes and cleanup.

v2.3.0Breaking3 fixes2 features
May 23, 2025

Version 2.3.0 removes Dynamic Max Retries support, updates dependencies including pyarrow, and introduces fixes for LLM responses and search prompts.

v2.2.12 fixes
May 1, 2025

This patch release addresses minor issues, including fixes for prompt tuning responses and missing edge weights in graph creation, alongside workflow updates.

v2.2.02 fixes2 features
Apr 26, 2025

This release introduces support for OpenAI reasoning models and adds an option to snapshot raw extracted graph tables, alongside various minor fixes and alignment updates.

v2.1.04 features
Mar 12, 2025

This minor release introduces support for JSON input files and updates the prompt tuning client with new metadata injection capabilities and output file naming conventions.

v2.0.0Breaking7 fixes11 features
Feb 25, 2025

Version 2.0.0 introduces major architectural changes, including reworking the API to accept callbacks, reorganizing workflows, and refactoring configuration management into type-safe dataclasses. This release also adds features like LLM provider registration and multi-index querying support.

v1.2.03 fixes2 features
Jan 15, 2025

This release introduces new features like the Drift Reduce endpoint and CosmosDB vector store, alongside several patch fixes and improvements.

Common Errors

BadRequestError9 reports

BadRequestError in graphrag often arises from incorrect data types or invalid values passed to the OpenAI API, particularly within parameters like `max_tokens`, `previous_response_id`, or content violating audit policies. To fix, carefully inspect the data being sent to the OpenAI API, ensuring all parameters conform to the expected data types and ranges as defined by the OpenAI documentation, and implement robust input validation and sanitization to prevent invalid or inappropriate content.

FailedToGenerateValidJsonError4 reports

The "FailedToGenerateValidJsonError" often arises when attempting to serialize Python objects containing unserializable data types (e.g., custom classes, SQLAlchemy models) directly into JSON. To resolve this, ensure all objects being serialized are primitive types (string, integer, boolean, list, dictionary) or provide custom serialization logic (e.g., using a `default` function in `json.dumps` or converting objects to dictionaries manually) to handle non-serializable attributes. Consider using libraries like `marshmallow` for complex object serialization.

FileNotFoundError2 reports

FileNotFoundError in graphrag usually means a specified file or database table path is incorrect or the resource doesn't exist at that location. Double-check the file path or table name for typos and ensure the file or table has been created or initialized before being accessed by the code. If using ChromaDB, ensure the collection name is spelled correctly and the database is accessible.

MaxRetryError1 report

MaxRetryError in graphrag usually indicates that the embedding model is failing to connect to the API endpoint due to network issues, incorrect API keys, or rate limiting. To fix this, verify your internet connection, carefully check that your API keys are correctly set, and implement a retry mechanism with exponential backoff to handle temporary failures and avoid exceeding rate limits; consider reducing the number of concurrent requests.

UnicodeDecodeError1 report

UnicodeDecodeError arises when Python tries to decode a byte sequence into a string using the wrong encoding. Specify the correct encoding when opening files or decoding byte strings, often 'utf-8' is the universal solution. For example, use `open("file.txt", "r", encoding="utf-8")` or `byte_string.decode("utf-8", errors='ignore')`, where errors='ignore' can help to ignore invalid characters.

NotFoundError1 report

The "NotFoundError" in graphrag, especially with Azure OpenAI, usually indicates the specified resource (like a deployment name) doesn't exist or isn't accessible in your Azure OpenAI setup. Verify the deployment name, API key, and endpoint are correctly configured in your code and match the Azure OpenAI resource you created. Ensure your Azure OpenAI resource has the necessary models deployed and your account has the correct permissions.

Related AI & LLMs Packages

Subscribe to Updates

Get notified when new versions are released

RSS Feed