LibreAI / RAG & Knowledge / nano-graphrag
// rag · gusye1234/nano-graphrag

nano-graphrag

nano-graphrag: a small, hackable GraphRAG implementation in about 1,100 lines — no Microsoft GraphRAG bulk

★ 4.0k stars⑂ 432 forksMITupdated 2026-01
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

nano-graphrag is an open-source rag & knowledge project by gusye1234 (gusye1234/nano-graphrag on GitHub). It has 3,993 GitHub stars and 432 forks, is released under the MIT license, and was last updated on GitHub on 27 January 2026.

GitHub stars
3,993
Forks
432
License
MIT
Last updated on GitHub
27 January 2026
Listing
Full install guide
// how it works

How it works

  1. Set your model access

    Export your OpenAI key (or configure Azure, Bedrock, or a local Ollama setup from the examples).

  2. Install the package

    Install from PyPI, or clone and install in editable mode to hack on the core.

  3. Insert your text

    Create a GraphRAG instance with a working directory and insert your documents.

  4. Query in modes

    Ask questions in local, global, and naive modes to compare graph-aware versus plain retrieval.

// features

Why people love it

Tiny, readable core

Roughly 1,100 lines implement the full GraphRAG pipeline — built to be hacked.

Local and global query modes

Entity-centric (local), community/theme-centric (global), and plain vector (naive) answering.

Incremental insertion

New text is deduplicated by md5 hashing and merged into the existing graph.

Async API

ainsert and aquery mirror the sync API for async applications.

Pluggable components

Swap chunking, LLM, and embedding functions and prompts; choose nano-vectordb, faiss, hnswlib, or milvus-lite, and networkx or Neo4j storage.

Multiple model backends

OpenAI by default, with Azure OpenAI, Amazon Bedrock, and Ollama examples.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Clone the project and enter its directory (or install from PyPI in the next step).

    git clone https://github.com/gusye1234/nano-graphrag.git
    cd nano-graphrag
  2. Install and set your key

    Install the package and export your OpenAI API key.

    pip install nano-graphrag
     export OPENAI_API_KEY="your-key"
  3. Insert and query

    Index a text file and ask a question in local mode, following the README quickstart.

    from nano_graphrag import GraphRAG, QueryParam
    graph_func = GraphRAG(working_dir="./dickens")
    graph_func.insert(open("book.txt").read())
    print(graph_func.query("What are the top themes?", param=QueryParam(mode="local")))
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains nano-graphrag?

Developer gusye1234 maintains nano-graphrag as an independent, community project inspired by Microsoft's GraphRAG.

Is it free?

Yes, MIT-licensed. Model calls bill to your own OpenAI/Azure/Bedrock keys, or run locally via Ollama examples.

Does it need a paid API key?

By default it expects an OpenAI API key; the repo includes examples for Azure OpenAI, Bedrock, and local Ollama models if you prefer.

How does it compare to Microsoft GraphRAG?

Microsoft's is the full research platform with extensive configuration. nano-graphrag trades breadth for a ~1,100-line core you can fully read and modify, with the same local/global query idea.

How do I get started?

Run `pip install nano-graphrag`, set OPENAI_API_KEY, create GraphRAG(working_dir=...), insert text, and query with QueryParam(mode="local").

// keep exploring

Similar tools

RAG & Knowledge

graphrag

Microsoft's graph-based RAG: index a corpus into a knowledge graph, then query it with an LLM

★ 36.3k starsMIT
View guide →
RAG & Knowledge

llmware

Unified framework for enterprise RAG pipelines with small, specialized models - local, private and secure.

★ 14.8k starsApache-2.0
View guide →
RAG & Knowledge

swirl-search

Federated AI search and RAG across 100+ apps — answers with sources, without moving your data

★ 3.0k starsApache-2.0
View guide →
RAG & Knowledge

PaddleOCR

Lightweight OCR toolkit turning PDFs and images into structured, LLM-ready data in 100+ languages

★ 90.8k starsApache-2.0
View guide →
RAG & Knowledge

docs-mcp

Self-hosted rag & knowledge: cometchat docs search + implementation bundles: add cha.

★ 97 starsApache-2.0
View guide →
// alternatives

Alternatives in RAG & Knowledge

The most-starred other RAG & Knowledge projects in the LibreAI catalogue — the realistic shortlist if nano-graphrag is not the right fit.

Get nano-graphrag

Free and open — grab the source, star the repo, and start creating.