Skip to content

Commit 5cb33fe

Browse files
committed
Add optional LLM cluster naming
1 parent 659d4d9 commit 5cb33fe

6 files changed

Lines changed: 1216 additions & 39 deletions

File tree

README.md

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ An interactive graph visualization tool for ladybugdb. Explore relationships bet
99
- **Visual Encoding** - Node size reflects connection count (more connections = larger nodes), and colors differentiate entity types.
1010
- **Dark/Light Mode** - Toggle between dark and light themes for comfortable viewing.
1111
- **Relationship Labels** - Hover over edges to see the type of relationship between connected nodes.
12+
- **Optional LLM Cluster Names** - Provide an LLM access token to name Leiden clusters from a random sample of 15 node labels in each cluster.
1213

1314
## Getting Started
1415

@@ -19,13 +20,10 @@ An interactive graph visualization tool for ladybugdb. Explore relationships bet
1920

2021
2. **Start the application**
2122
```bash
22-
npm run dev
23+
cargo tauri dev --features=icebug-analytics -- -- ../kg_history.lbdb
2324
```
2425

25-
3. **Open in browser**
26-
Navigate to `http://localhost:5173` to view the visualizer.
27-
28-
The application will automatically connect to the backend API at `http://localhost:3001` to fetch available databases and graph data. It will scan for databases starting from the parent directory looking for files with `.lbdb` extension.
26+
The application opens as a Tauri desktop app. Pass a `.lbdb` path after `-- --` to load that database at startup.
2927

3028
## Usage
3129

@@ -37,6 +35,12 @@ The application will automatically connect to the backend API at `http://localho
3735
6. Hover over edges to see relationship types
3836
7. Use the theme toggle button to switch between dark and light modes
3937

38+
## Optional LLM Cluster Naming
39+
40+
Cluster naming is disabled by default. To enable it, expand the sidebar's Cluster Names section, enter an LLM access token, and click Apply. Cluster computation still starts with local fallback names; the backend only sends a random sample of 15 labels for clusters that are currently visible in the drill view, then falls back to `Cluster N` if a request fails.
41+
42+
The endpoint defaults to `https://openrouter.ai`, and the model field defaults to `deepseek-v4-flash`. Base endpoints are sent through their `/api/v1/chat/completions` path, and both fields can be changed in the sidebar before applying.
43+
4044
## Requirements
4145

4246
- Node.js

0 commit comments

Comments
 (0)