graphrag-api

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #deep-learning #docker #windows #cli #vue #awesome-list #security #ios

(★ 112)

GraphRAG Server

graphrag-api Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# GraphRAG API [![GraphRAG v2.2.0](https://img.shields.io/badge/GraphRAG-v2.2.0-blue?style=flat-square)](https://pypi.org/project/graphrag/2.2.0/)

A FastAPI-based server that provides Global, Local, DRIFT, and Basic search capabilities based on [Microsoft GraphRAG](https://github.com/microsoft/graphrag).
Designed for easy integration with the [GraphRAG Visualizer](https://noworneverev.github.io/graphrag-visualizer/) or custom clients.

## Installation

Clone the repository and install the required dependencies using the following commands:

```bash
git clone git@github.com:noworneverev/graphrag-api.git
cd graphrag-api
```

```bash
python -m venv venv
```

```bash
source venv/bin/activate # for Linux
venv\Scripts\activate # for Windows
```

```bash
pip install -r requirements.txt
```

## Usage

1. Copy the entire GraphRAG project directory (e.g., `ragtest/`) into the root of this repository. This folder must contain at least: `output`, `prompts`, `settings.yaml` and `.env`.
2. In `config.py`, point `PROJECT_DIRECTORY` at that folder, and adjust any other options as needed:
   ```python
   PROJECT_DIRECTORY = "ragtest"     # ← name of the folder you just copied
   COMMUNITY_LEVEL = 2
   CLAIM_EXTRACTION_ENABLED = False
   RESPONSE_TYPE = "Single Paragraph"
   ```
3. Run the API
   ```
   python api.py
   ```

Open http://127.0.0.1:8000/docs/ to see the API documentation.

You can also use the interface at [GraphRAG Visualizer](https://noworneverev.github.io/graphrag-visualizer/) to run queries against the server.

![search](https://raw.githubusercontent.com/noworneverev/graphrag-api/main/static/image.png)

## API Endpoints

- `/search/global`: Perform a global search using GraphRAG.
- `/search/local`: Perform a local search using GraphRAG.
- `/search/drift`: Perform a DRIFT search using GraphRAG.
- `/search/basic`: Perform a basic search using text units.

graphrag-api

graphrag-api Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

graphrag-api

graphrag-api Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README