gmakstutis/LightRAG
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
LightRAG/lightrag_webui
History
clssck 48c7732edc feat: add automatic entity resolution with 3-layer matching 
Implement automatic entity resolution to prevent duplicate nodes in the
knowledge graph. The system uses a 3-layer approach:

1. Case-insensitive exact matching (free, instant)
2. Fuzzy string matching >85% threshold (free, instant)
3. Vector similarity + LLM verification (for acronyms/synonyms)

Key features:
- Pre-resolution phase prevents race conditions in parallel processing
- Numeric suffix detection blocks false matches (IL-4 ≠ IL-13)
- PostgreSQL alias cache for fast lookups on subsequent ingestion
- Configurable thresholds via environment variables

Bug fixes included:
- Fix fuzzy matching false positives for numbered entities
- Fix alias cache not being populated (missing db parameter)
- Skip entity_aliases table from generic id index creation

New files:
- lightrag/entity_resolution/ - Core resolution module
- tests/test_entity_resolution/ - Unit tests
- docker/postgres-age-vector/ - Custom PG image with pgvector + AGE
- docker-compose.test.yml - Integration test environment

Configuration (env.example):
- ENTITY_RESOLUTION_ENABLED=true
- ENTITY_RESOLUTION_FUZZY_THRESHOLD=0.85
- ENTITY_RESOLUTION_VECTOR_THRESHOLD=0.5
- ENTITY_RESOLUTION_MAX_CANDIDATES=3
2025-11-27 15:35:02 +01:00
..
public Fix linting 2025-05-12 23:27:41 +08:00
src feat: add automatic entity resolution with 3-layer matching 2025-11-27 15:35:02 +01:00
.env.development Fix swagger docs page problem in dev mode 2025-10-29 02:31:52 +08:00
.gitignore
.prettierrc.json
bun.lock Add @tailwindcss/typography plugin and fix Tailwind config 2025-10-14 03:14:38 +08:00
components.json
env.development.smaple Fix swagger docs page problem in dev mode 2025-10-29 02:31:52 +08:00
env.local.sample Fix redoc access problem in front-end dev mode 2025-10-17 20:36:15 +08:00
eslint.config.js
index.html
package.json Add @tailwindcss/typography plugin and fix Tailwind config 2025-10-14 03:14:38 +08:00
README.md Add frontend source code update warning 2025-10-14 10:59:21 +08:00
tailwind.config.js Add @tailwindcss/typography plugin and fix Tailwind config 2025-10-14 03:14:38 +08:00
tsconfig.json Add KaTeX mhchem extension support and improve math rendering 2025-09-28 15:13:04 +08:00
vite.config.ts Fix swagger docs page problem in dev mode 2025-10-29 02:31:52 +08:00

README.md

LightRAG WebUI

LightRAG WebUI is a React-based web interface for interacting with the LightRAG system. It provides a user-friendly interface for querying, managing, and exploring LightRAG's functionalities.

Installation

  1. Install Bun:

    If you haven't already installed Bun, follow the official documentation: https://bun.sh/docs/installation

  2. Install Dependencies:

    In the lightrag_webui directory, run the following command to install project dependencies:

    bun install --frozen-lockfile

  3. Build the Project:

    Run the following command to build the project:

    bun run build

    This command will bundle the project and output the built files to the lightrag/api/webui directory.

Development

  • Start the Development Server:

    If you want to run the WebUI in development mode, use the following command:

    bun run dev

Script Commands

The following are some commonly used script commands defined in package.json:

  • bun install: Installs project dependencies.
  • bun run dev: Starts the development server.
  • bun run build: Builds the project.
  • bun run lint: Runs the linter.