Practical overview
When it fits
Use it when you want an Open WebUI setup to query a GraphRAG-backed knowledge base, search broader context, add Tavily web results or combine these retrieval modes.
Who it is for
- Open WebUI operators adding GraphRAG retrieval to a question-answering setup
- Developers building search or retrieval-augmented systems around prepared knowledge-base files
- Teams seeking to use local language or embedding models in the documented configuration
Documented uses
- Search a local knowledge base using graph-based retrieval.
- Ask questions that require broader global context.
- Add internet search results through Tavily.
- Combine local, global and web retrieval for a broader search response.
- Connect the resulting API to Open WebUI.
Requirements & limits
The repository is public and specifies an Apache-2.0 license. The documented deployment is self-hosted; setup requires Python 3.8 or higher.
- Local search expects a prepared input directory with required files such as Parquet files.
- Tavily web search uses an external Tavily API and its API key.
- Local LLMs and embeddings are supported through documented configuration variables; the README also shows OpenAI-compatible API settings.
- The README warns that GraphRAG may need installation from a specific source if the listed dependency installation does not install it.
- The API exposes chat completions and a model-list endpoint, with Open WebUI configured to use the chat-completions URL.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Install and configure the API
Prepare the Python environment and set the documented configuration before starting the service.
Before you start
- Python 3.8 or higher
- The project repository and its requirements file
- An input directory containing required files, such as Parquet files
- Model and embedding credentials or local model endpoints as applicable; Tavily API key for Tavily search
Steps
Clone the repository and change into its directory.
Create and activate a Python virtual environment.
Install dependencies with the command below.
pip install -r requirements.txtConfigure the documented environment variables, including the input directory and the model, embedding, and search settings needed for the chosen setup.
Expected outcome
A configured project environment ready for the documented server-start stage.
Guide limitations
- The README notes that GraphRAG may need installation from a specific source if the requirements installation fails.
- This guide covers setup and configuration only; it does not establish that the service was executed or that a particular environment will work.
Connect the running API to Open WebUI
Point Open WebUI at the project’s documented chat-completions endpoint.
Before you start
- A configured GraphRAG4OpenWebUI environment
- Open WebUI
- The project API running at the documented local address
Steps
Start the API with the command below.
python main-en.pyIn Open WebUI configuration, set the API endpoint to
http://localhost:8012/v1/chat/completions.Use the documented chat-completions endpoint for search requests;
/v1/modelsis listed for retrieving available models.
Expected outcome
Open WebUI is configured to send search requests to the local GraphRAG4OpenWebUI API.
Guide limitations
- The README advises that asynchronous operations must be supported by the environment.
- For large-scale deployment, it recommends considering a production-grade ASGI server.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 15 October 2026
- Original website title
- win4r/GraphRAG4OpenWebUI · Official homepage title · retained in its source language

