77 lines
2.4 KiB
Markdown
77 lines
2.4 KiB
Markdown
# Database Inspector
|
|
|
|
Interactive TUI for browsing your LanceDB database.
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
# For haiku.rag-slim
|
|
pip install 'haiku.rag-slim[inspector]'
|
|
|
|
# Already included in haiku.rag
|
|
pip install haiku.rag
|
|
```
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
haiku-rag inspect
|
|
haiku-rag inspect --db /path/to/database.lancedb
|
|
```
|
|
|
|
## Interface
|
|
|
|
|
|
|
|
Three panels display your data:
|
|
|
|
- **Documents** (left) - All documents in the database
|
|
- **Chunks** (top right) - Chunks for the selected document
|
|
- **Detail View** (bottom right) - Full content and metadata
|
|
|
|
## Navigation
|
|
|
|
**Keyboard:**
|
|
|
|
- `Tab` - Cycle between panels
|
|
- `↑` / `↓` - Navigate lists
|
|
- `/` - Open search modal
|
|
- `c` - Open context expansion modal (when viewing a chunk)
|
|
- `v` - Open visual grounding modal (when viewing a chunk)
|
|
- `q` - Quit
|
|
|
|
**Mouse:** Click to select, scroll to view content
|
|
|
|
## Search
|
|
|
|
Press `/` to open the full-screen search modal:
|
|
|
|
- Enter your query and press `Enter` to search
|
|
- **Left panel**: Search results with relevance scores `[0.95] content preview`
|
|
- **Right panel**: Full chunk content and metadata
|
|
- Use `↑` / `↓` to navigate results - detail view updates in real-time
|
|
- Press `Enter` on a result to close search and navigate to that document/chunk
|
|
- Press `Esc` to close search without selecting
|
|
|
|
Search uses hybrid (vector + full-text) search across all chunks. Content is rendered as markdown with syntax highlighting.
|
|
|
|
## Context Expansion
|
|
|
|
Press `c` while viewing a chunk to open the context expansion modal:
|
|
|
|
- Shows the expanded context that would be provided to the QA agent
|
|
- Type-aware expansion: tables, code blocks, and lists expand to their complete structures
|
|
- Text content expands based on `text_context_radius` setting
|
|
- Includes metadata like source document, content type, and relevance score
|
|
- Press `Esc` to close the modal
|
|
|
|
## Visual Grounding
|
|
|
|
Press `v` while viewing a chunk to open the visual grounding modal:
|
|
|
|
- Shows page images from the source document with the chunk's location highlighted in yellow/orange
|
|
- Use `←` / `→` arrow keys to navigate between pages (when chunk spans multiple pages)
|
|
- Press `Esc` to close the modal
|
|
|
|
!!! note
|
|
Visual grounding requires documents with a stored DoclingDocument that includes page images. Text-only documents or documents imported without DoclingDocument won't have visual grounding available.
|