vector-watcher

Vector Watcher é um aplicativo desktop multiplataforma para inspecionar e gerenciar bancos de dados vetoriais LanceDB por meio de uma interface gráfica. Ele é voltado para usuários que trabalham com embeddings vetoriais locais ou remotos e desejam navegá-los, consultá-los e organizá-los sem a necessidade de escrever scripts. ## O que ele faz - **Gerenciador de conexões** — configura, persiste e alterna entre múltiplas instâncias locais ou remotas do LanceDB. - **Inspetor de esquemas e tabelas** — navega por conjuntos de dados vetoriais, esquemas estruturais, metadados e contagens de linhas. - **Busca de similaridade vetorial** — executa consultas de distância usando métricas L2, Cosine ou Dot Product diretamente da UI. - **Sidecar de configuração zero** — o backend Python local é gerenciado automaticamente e roda em um socket de loopback isolado em `127.0.0.1:8765`. ## Arquitetura O projeto combina um host nativo Tauri (Rust) com um frontend webview em React/TypeScript. O núcleo do Tauri gerencia um motor Python/FastAPI integrado, lançado como um processo sidecar via Uvicorn, que por sua vez se comunica com o LanceDB Core (versão declarada 0.30.2) através de bindings nativos. A comunicação entre a webview e o host nativo utiliza IPC de webview local; o backend é vinculado localmente em vez de ser exposto na rede. ## Instalação Binários pré-compilados são publicados na página de Releases do projeto. Os alvos documentados incluem Linux (Ubuntu 24.04+, x86_64/arm64, `.AppImage` e `.deb`), macOS (Apple Silicon e Intel, `.dmg`) e Windows 11 (x64, `.msi` e setup `.exe`). ## Desenvolvimento O repositório é um monorepo dividido em diretórios `frontend` e `backend`. Os pré-requisitos listados são Node.js v20+ LTS, um toolchain Rust estável recente para Tauri e Python 3.11+ com Poetry. As etapas de configuração abrangem `npm install` no frontend, `poetry install` mais um script de inicialização para o sidecar Python, e a execução do comando de dev do Tauri. Instaladores independentes são produzidos executando o script de build do backend e, em seguida, um script `tauri:build` específico da plataforma. ## Documentação e comunidade Materiais adicionais — guia do usuário e operações, notas de arquitetura e protocolo FastAPI, e fluxo de trabalho de empacotamento/sidecar binário — são mantidos na Wiki do GitHub do projeto. O projeto é mantido por Keshav Mohta e Dhwani Khandelwal, aceita issues e pull requests, e é distribuído sob a Licença MIT. ## Notas Esta visão geral reflete apenas o que o README documenta: um cliente GUI desktop para LanceDB. Características de desempenho, limites de tamanho de conjunto de dados e o conjunto completo de recursos além das capacidades listadas não são descritos no material de origem.