whatisgithub

What is knowbase_ai?

minjie05/knowbase_ai — explained in plain English

Analysis updated 2026-05-18

62PythonAudience · developerComplexity · 4/5Setup · hard

In one sentence

A Python backend for building a Q&A system over your own product documents, combining vector, graph, and keyword search before an LLM answers.

Mindmap

mindmap
  root((repo))
    What it does
      Q and A over documents
      Product doc search
      Answers from your data
    Tech stack
      Python and FastAPI
      Milvus and Neo4j
      LangGraph
    Use cases
      Upload PDF or Markdown docs
      Combine multiple search paths
      Run fully local via Docker
    Audience
      Developers
      Product teams
    Retrieval methods
      Vector search
      HyDE search
      Graph based search

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Upload PDF or Markdown product docs and let customers ask questions about them in plain language.

USE CASE 2

Combine vector search, graph search, and keyword search to answer complex product questions accurately.

USE CASE 3

Run a full local retrieval-augmented answer system using Docker for the databases.

USE CASE 4

Swap in any OpenAI-compatible language model instead of the default Tongyi Qianwen.

What is it built with?

PythonFastAPIMilvusNeo4jLangGraphDocker

How does it compare?

minjie05/knowbase_aiernie-research/navaheartune/robotheory-79k
Stars626262
LanguagePythonPythonPython
Setup difficultyhardhardmoderate
Complexity4/55/53/5
Audiencedeveloperresearcherresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Needs Docker to run Milvus, Neo4j, MongoDB, and MinIO plus API access to a language model.

The README does not state a license.

So what is it?

KnowBase_AI, also titled ShopKeeper Brain, is a Python backend that lets you build a question-and-answer system on top of your own product documents. The core idea is that you upload PDF or Markdown files describing your products, the system processes and stores them, and customers (or staff) can then ask questions in plain language and get answers pulled from those documents rather than from a generic AI. The document import pipeline runs in eight sequential steps. It parses PDFs into structured text using a tool called MinerU, which handles tables, formulas, and multi-column layouts. It then splits the text into chunks, identifies which product each chunk belongs to, and creates two types of numeric representations (dense vectors that capture meaning and sparse vectors that capture keywords) using a locally hosted model called BGE-M3. Those representations go into a vector database called Milvus. At the same time, the system uses a language model to extract the entities and relationships in each chunk and stores them in Neo4j, a graph database, so structural connections between product concepts are preserved. When a user asks a question, the system takes several parallel retrieval paths at once: a conventional vector search against Milvus, a second search that first generates a hypothetical answer and then searches on that (a technique called HyDE that often works better for complex questions), and a graph-based search against Neo4j. A web search via a local MCP tool can also contribute results. The results from all paths are combined using a ranking method called RRF, then re-ranked by a cross-encoder model for accuracy, and finally passed to a large language model that produces the response. The infrastructure runs locally: Milvus, Neo4j, MongoDB (for conversation history), and MinIO (for file storage) can each be started with a single Docker command. The language model calls go to Tongyi Qianwen (Alibaba DashScope) by default, though any OpenAI-compatible endpoint works. The FastAPI backend exposes the import and query pipelines as API endpoints, and LangGraph orchestrates the multi-step flows.

Copy-paste prompts

Prompt 1
Help me set up Milvus, Neo4j, MongoDB, and MinIO with Docker for this project.
Prompt 2
Explain how the HyDE retrieval technique works in this codebase's query pipeline.
Prompt 3
Show me how to swap the default language model for a different OpenAI-compatible endpoint.
Prompt 4
Walk me through the eight-step document import pipeline in this repo.

Frequently asked questions

What is knowbase_ai?

A Python backend for building a Q&A system over your own product documents, combining vector, graph, and keyword search before an LLM answers.

What language is knowbase_ai written in?

Mainly Python. The stack also includes Python, FastAPI, Milvus.

What license does knowbase_ai use?

The README does not state a license.

How hard is knowbase_ai to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is knowbase_ai for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.