●Change8

Migrating to GraphRAG v3.0.0

Version v3.0.0 introduces 2 breaking changes. This guide details how to update your code.

Released: 1/28/2026

2
Breaking Changes
1
Migration Steps
0
Affected Symbols

Breaking Changes

●Issue #1

The project structure has undergone a major monorepo restructure, requiring users to reinitialize configuration.

●Issue #2

All previous imports for components must be updated to reflect the new package structure (e.g., components are now in graphrag-cache, graphrag-chunking, etc.).

Migration Steps

  1. 1
    Run graphrag init --force to reinitialize configuration files to match the new layout and options.

Release Summary

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

Need More Details?

View the full release notes and all changes for GraphRAG v3.0.0.

View Full Changelog