{"id":40789465,"url":"https://github.com/anthonypdawson/vector-inspector","last_synced_at":"2026-04-07T21:02:43.693Z","repository":{"id":333178711,"uuid":"1136468407","full_name":"anthonypdawson/vector-inspector","owner":"anthonypdawson","description":"The missing developer tool for working with vector databases. A comprehensive desktop app for visualizing, querying, and managing vector data.","archived":false,"fork":false,"pushed_at":"2026-03-30T22:46:51.000Z","size":7641,"stargazers_count":5,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-03-31T00:32:20.986Z","etag":null,"topics":["chromadb","clustering","data-visualization","developer-tools","embedding-vectors","embeddings","hdbscan","hnsw","lancedb","pgvector","pinecone","pyside6","qdrant","rag","retrieval-augmented-generation","semantic-search","vector-database","vector-db","vector-inspector","vector-search"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/anthonypdawson.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-17T18:39:33.000Z","updated_at":"2026-03-22T00:38:55.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/anthonypdawson/vector-inspector","commit_stats":null,"previous_names":["anthonypdawson/vector-viewer","anthonypdawson/vector-inspector"],"tags_count":32,"template":false,"template_full_name":null,"purl":"pkg:github/anthonypdawson/vector-inspector","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anthonypdawson%2Fvector-inspector","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anthonypdawson%2Fvector-inspector/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anthonypdawson%2Fvector-inspector/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anthonypdawson%2Fvector-inspector/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/anthonypdawson","download_url":"https://codeload.github.com/anthonypdawson/vector-inspector/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anthonypdawson%2Fvector-inspector/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31528752,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T16:28:08.000Z","status":"ssl_error","status_checked_at":"2026-04-07T16:28:06.951Z","response_time":105,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chromadb","clustering","data-visualization","developer-tools","embedding-vectors","embeddings","hdbscan","hnsw","lancedb","pgvector","pinecone","pyside6","qdrant","rag","retrieval-augmented-generation","semantic-search","vector-database","vector-db","vector-inspector","vector-search"],"created_at":"2026-01-21T20:00:14.250Z","updated_at":"2026-04-07T21:02:43.687Z","avatar_url":"https://github.com/anthonypdawson.png","language":"Python","readme":"\n# Vector Inspector\n\n[![CI](https://github.com/anthonypdawson/vector-inspector/actions/workflows/ci-tests.yml/badge.svg?branch=master)](https://github.com/anthonypdawson/vector-inspector/actions/workflows/ci-tests.yml) [![Coverage Status](https://coveralls.io/repos/github/anthonypdawson/vector-inspector/badge.svg?branch=master)](https://coveralls.io/github/anthonypdawson/vector-inspector?branch=master)\n[![Publish](https://github.com/anthonypdawson/vector-inspector/actions/workflows/release-and-publish.yml/badge.svg?branch=master)](https://github.com/anthonypdawson/vector-inspector/actions/workflows/release-and-publish.yml)\n\n[![PyPI Version](https://img.shields.io/pypi/v/vector-inspector.svg?cacheSeconds=300)](https://pypi.org/project/vector-inspector/)\n[![PyPI Downloads](https://static.pepy.tech/personalized-badge/vector-inspector?period=total\u0026units=INTERNATIONAL_SYSTEM\u0026left_color=BLACK\u0026right_color=GREEN\u0026left_text=downloads)](https://pepy.tech/projects/vector-inspector)\n\nThe ultimate toolkit for vector databases - a comprehensive desktop app to inspect, query, and visualize your embeddings across Chroma, Qdrant, Weaviate, Pinecone, LanceDB, pgvector and more.\n\n\nSimilar to SQL viewers (DBeaver/TablePlus) but built for vector databases, Vector Inspector offers an intuitive GUI for exploring embeddings, metadata, similarity search, and CRUD across multiple providers.\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"site/images/demo.gif\" target=\"_blank\"\u003e\n    \u003cimg src=\"site/images/demo.gif\" alt=\"Vector Inspector Demo\" width=\"600\"/\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n**Quick Demo:** See Vector Inspector in action!\n\n## Overview\n\nVector Inspector bridges the gap between vector databases and user-friendly data exploration tools. While vector databases are powerful for semantic search and AI applications, they often lack the intuitive inspection and management tools that traditional SQL databases have. This project aims to provide that missing layer.\n\n---\n\n## Homepage\n[https://vector-inspector.divinedevops.com](https://vector-inspector.divinedevops.com)\n\n\n# 🟦 Installation\n\n## Quick Install (recommended)\n\nThese installers work on **macOS, Linux, and Windows (PowerShell or Git Bash)**.\n\n### macOS \u0026 Linux\n```\ncurl -fsSL https://vector-inspector.divinedevops.com/install.sh | bash\n```\n\n### Windows (PowerShell)\n```\npowershell -c \"iwr https://vector-inspector.divinedevops.com/install.ps1 -UseBasicParsing | iex\"\n```\n\n### Windows (Git Bash)\n```\ncurl -fsSL https://vector-inspector.divinedevops.com/install.sh | bash\n```\n\nThese scripts:\n\n- install Vector Inspector  \n- create a desktop shortcut  \n- launch the app immediately  \n\nThis is the easiest and most reliable way to get started.\n\n## From PyPI\n\n```bash\npip install vector-inspector\nvector-inspector\n```\n\n## From a Downloaded Wheel or Tarball (e.g., GitHub Release)\n\nDownload the `.whl` or `.tar.gz` file from the [GitHub Releases](https://github.com/anthonypdawson/vector-inspector/releases) page, then install with:\n\n```bash\npip install \u003cyour-filename.whl\u003e\n# or\npip install \u003cyour-filename.tar.gz\u003e\n```\n\nAfter installation, run the application with:\n\n```bash\nvector-inspector\n```\nNote: pip install does **not** create a desktop shortcut.  \nUse the bootstrap installer for the full experience.\n\n### From Source\n\n```bash\n# Clone the repository\ngit clone https://github.com/anthonypdawson/vector-inspector.git\ncd vector-inspector\n\n# Install dependencies using PDM\npdm install\n\n# Launch application\nscripts/run.sh     # Linux/macOS\nscripts/run.bat    # Windows\n```\n---\n\n# 🟩 Running Vector Inspector\n\n```\nvector-inspector\n```\n\u003e Note: The Quick Install script launches the app automatically. If you installed via pip or from source, use the command above.\n\u003e This opens the full desktop application.\n\n### Optional LLM runtime (llama-cpp-python)\nllama-cpp-python is optional and only needed for the in-process LLM provider (`llama-cpp`).\n\n- Install via PDM optional-dependency group (developer / recommended):\n\n```bash\npdm install -G llm\n```\n\n- Platform-specific pip install (end users / PyPI):\n\nWindows (pre-built CPU wheel index):\n```powershell\npip install llama-cpp-python --prefer-binary \\\n  --extra-index-url https://abetlen.github.io/llama-cpp-python/whl/cpu\n```\n\nLinux / macOS (official wheels / source build):\n```bash\npip install llama-cpp-python\n```\n\nCUDA / GPU wheels (pick matching CUDA version):\n```bash\npip install llama-cpp-python --prefer-binary \\\n  --extra-index-url https://abetlen.github.io/llama-cpp-python/whl/cu121\n```\n\n- Scripts included in this repo:\n  - `scripts/install-llm-windows.ps1` — PowerShell helper for Windows\n  - `scripts/install-llm-unix.sh` — bash helper for Linux/macOS\n\nNotes:\n- If you cannot build native wheels on Windows, use the Windows pre-built index above.\n- **Vector Studio users** can use **Settings → LLM → \"Download default model\"** to automatically download the default Phi-3-mini GGUF model into the local cache. This button is disabled in the free Vector Inspector tier.\n- **Free-tier users** should download a GGUF model manually (or use the scripts above) and set the path in Settings → LLM, or configure Ollama (local server) or an OpenAI-compatible API instead.\n\n---\n## Table of Contents\n\n- [Key Features](#key-features)\n- [Architecture](#architecture)\n- [Use Cases](#use-cases)\n- [Feature Access](#feature-access)\n- [Roadmap](#roadmap)\n- [Configuration](#configuration)\n- [Development Setup](#development-setup)\n- [Contributing](#contributing)\n- [License](#license)\n- [Acknowledgments](#acknowledgments)\n\n## Key Features\n\n\u003e **Note:** Some features listed below may be not started or currently in progress.\n\n### 1. **Multi-Provider Support**\n- Connect to vector databases:\n  - ChromaDB (persistent local storage)\n  - Qdrant (remote server or embedded local)\n  - Pinecone (cloud-hosted)\n  - Milvus (remote server or Milvus Lite) (Only on MacOs/Linux, experimental) - In Progress\n  - LanceDB (persistent local storage) — requires `lancedb\u003e=0.27.0`, `pyarrow\u003e=14.0.0`\n  - PgVector/PostgreSQL (remote server)\n  - Weaviate (Local/Remote + WCD/Cloud)\n- Unified interface regardless of backend provider\n- Automatically saves last connection configuration\n- Secure API key storage for cloud providers\n\n### 2. **Data Visualization**\n- **Metadata Explorer**: Browse and filter vector entries by metadata fields\n- **Vector Dimensionality Reduction**: Visualize high-dimensional vectors in 2D/3D using:\n  - t-SNE\n  - UMAP\n  - PCA\n- **Cluster Visualization**: Color-code vectors by metadata categories or clustering results\n- **Interactive Plots**: Zoom, pan, and select vectors for detailed inspection\n- **Data Distribution Charts**: Histograms and statistics for metadata fields\n\n### 3. **Search \u0026 Query Interface**\n- **Similarity Search**: \n  - Text-to-vector search (with embedding model integration)\n  - Vector-to-vector search\n  - Find similar items to selected entries\n  - Adjustable top-k results and similarity thresholds\n- **Metadata Filtering**:\n  - SQL-like query builder for metadata\n  - Combine vector similarity with metadata filters\n  - Advanced filtering: ranges, IN clauses, pattern matching\n- **Hybrid Search**: Combine semantic search with keyword search\n- **Query History**: Save and reuse frequent queries\n\n### 4. **Data Management**\n- **Browse Collections/Indexes**: View all available collections with statistics\n- **CRUD Operations**:\n  - View individual vectors and their metadata\n  - Add new vectors (with auto-embedding options)\n  - Update metadata fields\n  - Delete vectors (single or batch)\n- **Bulk Import/Export**:\n  - Import from CSV, JSON, Parquet\n  - Export query results to various formats\n  - Backup and restore collections\n- **Schema Inspector**: View collection configuration, vector dimensions, metadata schema\n\n### 5. **SQL-Like Experience**\n- **Query Console**: Write queries in a familiar SQL-like syntax (where supported)\n- **Results Grid**: \n  - Sortable, filterable table view\n  - Pagination for large result sets\n  - Column customization\n- **Data Inspector**: Click any row to see full details including raw vector\n- **Query Execution Plans**: Understand how queries are executed\n- **Auto-completion**: Intelligent suggestions for collection names, fields, and operations\n\n### 6. **Advanced Features**\n- **Embedding Model Integration**:\n  - Use OpenAI, Cohere, HuggingFace models for text-to-vector conversion\n  - Local model support (sentence-transformers)\n  - Custom model integration\n- **Vector Analysis**:\n  - Compute similarity matrices\n  - Identify outliers and anomalies\n  - Cluster analysis with k-means, DBSCAN\n- **Embedding Inspector**:\n  - For similar collections or items, automatically identify which vector dimensions (activations) most contribute to the similarity\n  - Map key activations to interpretable concepts (e.g., 'humor', 'sadness', 'anger') using metadata or labels\n  - Generate human-readable explanations for why items are similar\n- **Performance Monitoring**:\n  - Query latency tracking\n  - Index performance metrics\n  - Connection health monitoring\n\n## Architecture\n\nVector Inspector is built with PySide6 (Qt for Python) for the GUI, providing a native desktop experience. The backend uses Python with support for multiple vector database providers through a unified interface.\n\nFor detailed architecture information, see [docs/architecture.md](docs/architecture.md).\n\n## Use Cases\n\n1. **AI/ML Development**: Inspect embeddings generated during model development\n2. **RAG System Debugging**: Verify what documents are being retrieved\n3. **Data Quality Assurance**: Identify poorly embedded or outlier vectors\n4. **Production Monitoring**: Check vector database health and data consistency\n5. **Data Migration**: Transfer data between vector database providers\n6. **Education**: Learn and experiment with vector databases interactively\n\n## Feature Access\n\nVector Inspector follows a user-friendly monetization model:\n\n- **All vector database providers are free** — Try the full app with any database\n- **Core workflows remain free** — Connect, browse, search, visualize, and manage your data\n- **Pro adds power tools** — Advanced analytics, enterprise formats, workflow automation, and collaboration\n\n**Nothing currently in Free will ever move to Pro.** See [FEATURES.md](docs/FEATURES.md) for a detailed comparison.\n\n## Roadmap\n\n**Current Status**: ✅ Phase 2 Complete\n\nSee [ROADMAP.md](docs/ROADMAP.md) for the complete development roadmap and planned features.\n\n\n## Configuration\n\nPaths are resolved relative to the project root (where `pyproject.toml` is). For example, entering `./data/chroma_db` will use the absolute path resolved from the project root.\n\nThe application automatically saves your last connection configuration to `~/.vector-inspector/settings.json`. The next time you launch the application, it will attempt to reconnect using the last saved settings.\n\nExample settings structure:\n```json\n{\n  \"last_connection\": {\n    \"provider\": \"chromadb\",\n    \"connection_type\": \"persistent\",\n    \"path\": \"./data/chroma_db\"\n  }\n}\n```\n\n## Development Setup\n\n```bash\n# Install PDM if you haven't already\npip install pdm\n\n# Install dependencies with development tools (PDM will create venv automatically)\npdm install -d\n\n# Run tests\npdm run pytest\n\n# Run application in development mode\n./run.sh     # Linux/macOS\n./run.bat    # Windows\n\n# Or use Python module directly from src directory:\ncd src\npdm run python -m vector_inspector\n```\n\n## Contributing\n\nContributions are welcome! Areas where help is needed:\n- Additional vector database provider integrations\n- UI/UX improvements\n- Performance optimizations\n- Documentation\n- Test coverage\n\nPlease see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n## License\n\nMIT License - See [LICENSE](LICENSE) file for details.\n\n## Acknowledgments\n\nThis project draws inspiration from:\n- DBeaver (SQL database viewer)\n- MongoDB Compass (NoSQL database GUI)\n- Pinecone Console\n- Various vector database management tools\n\n---\n\n\nSee [CHANGELOG.md](CHANGELOG.md) for the latest status and what's new in each release.\n\nSee [GETTING_STARTED.md](GETTING_STARTED.md) for usage instructions and [IMPLEMENTATION_SUMMARY.md](IMPLEMENTATION_SUMMARY.md) for technical details.\n\n**Contact**: Anthony Dawson\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanthonypdawson%2Fvector-inspector","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fanthonypdawson%2Fvector-inspector","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanthonypdawson%2Fvector-inspector/lists"}