vector-watcher

Vector Watcher는 그래픽 인터페이스를 통해 LanceDB 벡터 데이터베이스를 검사하고 관리할 수 있는 크로스 플랫폼 데스크톱 애플리케이션입니다. 스크립트를 작성하지 않고 로컬 또는 원격 벡터 임베딩을 찾아보고 쿼리하며 정리하려는 사용자를 대상으로 합니다. ## 주요 기능 - **연결 관리자** — 여러 로컬 또는 원격 LanceDB 인스턴스를 구성, 유지 및 전환할 수 있습니다. - **스키마 및 테이블 검사기** — 벡터 데이터셋, 구조적 스키마, 메타데이터 및 행 수를 탐색합니다. - **벡터 유사도 검색** — UI에서 직접 L2, Cosine 또는 Dot Product 메트릭을 사용하여 거리 쿼리를 실행합니다. - **제로 설정 사이드카** — 로컬 Python 백엔드가 자동으로 관리되며 `127.0.0.1:8765`의 격리된 루프백 소켓에서 실행됩니다. ## 아키텍처 이 프로젝트는 Tauri 네이티브 호스트(Rust)와 React/TypeScript 웹뷰 프런트엔드를 결합했습니다. Tauri 코어는 Uvicorn을 통해 사이드카 프로세스로 실행되는 번들형 Python/FastAPI 엔진을 관리하며, 이는 다시 네이티브 바인딩을 통해 LanceDB Core(버전 0.30.2)와 통신합니다. 웹뷰와 네이티브 호스트 간의 통신은 로컬 웹뷰 IPC를 사용하며, 백엔드는 네트워크에 노출되지 않고 로컬에 바인딩됩니다. ## 설치 사전 컴파일된 바이너리는 프로젝트의 Releases 페이지에 게시됩니다. 지원 대상으로는 Linux(Ubuntu 24.04+, x86_64/arm64, `.AppImage` 및 `.deb`), macOS(Apple Silicon 및 Intel, `.dmg`), Windows 11(x64, `.msi` 및 설치 `.exe`)이 포함됩니다. ## 개발 저장소는 `frontend`와 `backend` 디렉토리로 나뉜 모노레포 구조입니다. 필수 요구 사항으로는 Node.js v20+ LTS, Tauri를 위한 최신 안정 버전의 Rust 툴체인, Poetry가 포함된 Python 3.11+가 명시되어 있습니다. 설정 단계는 프런트엔드의 `npm install`, Python 사이드카를 위한 `poetry install` 및 시작 스크립트 실행, 그리고 Tauri 개발 명령 실행을 포함합니다. 독립 실행형 설치 프로그램은 백엔드 빌드 스크립트를 실행한 후 플랫폼별 `tauri:build` 스크립트를 실행하여 생성합니다. ## 문서 및 커뮤니티 사용자 가이드 및 운영, 아키텍처 및 FastAPI 프로토콜 노트, 패키징/바이너리 사이드카 워크플로우 등 추가 자료는 프로젝트의 GitHub Wiki에 보관되어 있습니다. 이 프로젝트는 Keshav Mohta와 Dhwani Khandelwal이 유지 관리하며, 이슈 제기와 풀 리퀘스트를 환영하며 MIT 라이선스 하에 배포됩니다. ## 참고 사항 이 개요는 README에 문서화된 내용, 즉 LanceDB를 위한 데스크톱 GUI 클라이언트라는 점만을 반영합니다. 성능 특성, 데이터셋 크기 제한 및 나열된 기능 외의 전체 기능 세트는 소스 자료에 설명되어 있지 않습니다.