vector-inspector 0.3.9__tar.gz → 0.3.12__tar.gz

vector_inspector-0.3.12/LICENSE

@@ -0,0 +1 @@
+All rights reserved. Anthony Dawson

{vector_inspector-0.3.9 → vector_inspector-0.3.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: vector-inspector
-Version: 0.3.9
+Version: 0.3.12
 Summary: A comprehensive desktop application for visualizing, querying, and managing vector database data
 Author-Email: Anthony Dawson <anthonypdawson+github@gmail.com>
 License: MIT
@@ -8,7 +8,7 @@ Project-URL: Homepage, https://vector-inspector.divinedevops.com
 Project-URL: Source, https://github.com/anthonypdawson/vector-inspector
 Project-URL: Issues, https://github.com/anthonypdawson/vector-inspector/issues
 Project-URL: Documentation, https://github.com/anthonypdawson/vector-inspector#readme
-Requires-Python: <3.14,>=3.10
+Requires-Python: >=3.10
 Requires-Dist: chromadb>=0.4.22
 Requires-Dist: qdrant-client>=1.7.0
 Requires-Dist: pyside6>=6.6.0
@@ -26,45 +26,19 @@ Requires-Dist: keyring>=25.7.0
 Requires-Dist: hf-xet>=1.2.0
 Requires-Dist: pymilvus>=2.6.6
 Requires-Dist: lancedb>=0.27.0
-Requires-Dist: psycopg2>=2.9.11
+Requires-Dist: psycopg2-binary>=2.9.11
 Requires-Dist: pgvector>=0.4.2
 Description-Content-Type: text/markdown
 
 # Latest updates
 
-- Major refactor and studio-ready architecture
-  - Refactored main window into modular components (InspectorShell, ProviderFactory, DialogService, ConnectionController, InspectorTabs)
-  - MainWindow is reusable as a widget; tab system is pluggable so Studio can extend or override tabs
-
-- Data browser improvements
-  - Added Generate embeddings on edit (persisted per user)
-
-- Settings / Preferences
-  - SettingsService persists preferences and exposes typed accessors (breadcrumb, search defaults, auto-embed, window geometry)
-  - SettingsService emits a setting_changed Qt signal so UI reacts immediately
-  - SettingsDialog (modal) added with add_section API and hook integration for extension panels
-  - Breadcrumb controls moved out of core so Pro (Vector Studio) injects them via the settings_panel_hook
-
-- Extension hook for settings panels
-  - *settings_panel_hook* added to *vector_inspector.extensions*; Vector Studio registers breadcrumb controls at startup
-
-- Breadcrumb and UI improvements
-  - Breadcrumb label now elides long trails (left/middle) and shows full trail on hover
-  - SearchView supports runtime elide-mode changes and responds to settings signals
-
-- Window geometry persistence
-  - Main window saves/restores geometry when window.restore_geometry is enabled
-
-- Pro (Vector Studio) features
-  - *Search Similar* (Pro): right-click any row in Data Browser or Search Results to run a vector-to-vector similarity search
-  - *table_context_menu* handler hardened for many embedding/id formats and includes fallbacks
-  - Vector Studio injects breadcrumb controls into Settings dialog via *settings_panel_hook*
-
-- Tests and CI
-  - Added *tests/test_settings_injection.py* to assert settings panel hook registration
-  - Updated context-menu tests to use *log_info* and *assert* for pytest
-  - Local test run: 5 tests passed; GUI-heavy suite ~9s due to PySide6 startup
-
+## Pinecone Hosted Model Support Improvements
+  - Direct Text Search: Added full support for Pinecone indexes with integrated (hosted) embedding models. You can now perform semantic search using plain text queries—no local embedding required.
+  - Accurate Model Detection: The app now detects and displays the hosted model name (e.g., llama-text-embed-v2) in the info panel for Pinecone indexes.
+  - Robust Query Handling: The search logic now uses Pinecone’s search() API for hosted models, with correct response parsing and error handling.
+  - Future-Proof: Retained the ability to generate embeddings via Pinecone’s inference API for future features or advanced workflows.
+  - Improved Error Handling: Added better checks and debug logging for Pinecone API responses.
+  - These changes make Pinecone integration seamless and future-ready for both text and vector search scenarios.
 ---
 
 # Vector Inspector
@@ -72,7 +46,7 @@ Description-Content-Type: text/markdown
 > **Disclaimer:** This tool is currently under active development and is **not production ready**. Not all features have been thoroughly tested and code is released frequently. Use with caution in critical or production environments.
 
 [![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)
-[![Publish](https://github.com/anthonypdawson/vector-inspector/actions/workflows/publish%20copy.yml/badge.svg?branch=master)](https://github.com/anthonypdawson/vector-inspector/actions/workflows/publish%20copy.yml)
+[![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)
 
 [![PyPI Version](https://img.shields.io/pypi/v/vector-inspector.svg?cacheSeconds=300)](https://pypi.org/project/vector-inspector/)
 [![PyPI Downloads](https://static.pepy.tech/personalized-badge/vector-inspector?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads)](https://pepy.tech/projects/vector-inspector)
@@ -80,6 +54,14 @@ Description-Content-Type: text/markdown
 
 A comprehensive desktop application for visualizing, querying, and managing vector database data. Similar to SQL database viewers, Vector Inspector provides an intuitive GUI for exploring vector embeddings, metadata, and performing similarity searches across multiple vector database providers.
 
+<p align="center">
+  <a href="site/images/demo.gif" target="_blank">
+    <img src="site/images/demo.gif" alt="Vector Inspector Demo" width="600"/>
+  </a>
+</p>
+
+**Quick Demo:** See Vector Inspector in action!
+
 ## Overview
 
 Vector 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.

{vector_inspector-0.3.9 → vector_inspector-0.3.12}/README.md

@@ -1,38 +1,12 @@
 # Latest updates
 
-- Major refactor and studio-ready architecture
-  - Refactored main window into modular components (InspectorShell, ProviderFactory, DialogService, ConnectionController, InspectorTabs)
-  - MainWindow is reusable as a widget; tab system is pluggable so Studio can extend or override tabs
-
-- Data browser improvements
-  - Added Generate embeddings on edit (persisted per user)
-
-- Settings / Preferences
-  - SettingsService persists preferences and exposes typed accessors (breadcrumb, search defaults, auto-embed, window geometry)
-  - SettingsService emits a setting_changed Qt signal so UI reacts immediately
-  - SettingsDialog (modal) added with add_section API and hook integration for extension panels
-  - Breadcrumb controls moved out of core so Pro (Vector Studio) injects them via the settings_panel_hook
-
-- Extension hook for settings panels
-  - *settings_panel_hook* added to *vector_inspector.extensions*; Vector Studio registers breadcrumb controls at startup
-
-- Breadcrumb and UI improvements
-  - Breadcrumb label now elides long trails (left/middle) and shows full trail on hover
-  - SearchView supports runtime elide-mode changes and responds to settings signals
-
-- Window geometry persistence
-  - Main window saves/restores geometry when window.restore_geometry is enabled
-
-- Pro (Vector Studio) features
-  - *Search Similar* (Pro): right-click any row in Data Browser or Search Results to run a vector-to-vector similarity search
-  - *table_context_menu* handler hardened for many embedding/id formats and includes fallbacks
-  - Vector Studio injects breadcrumb controls into Settings dialog via *settings_panel_hook*
-
-- Tests and CI
-  - Added *tests/test_settings_injection.py* to assert settings panel hook registration
-  - Updated context-menu tests to use *log_info* and *assert* for pytest
-  - Local test run: 5 tests passed; GUI-heavy suite ~9s due to PySide6 startup
-
+## Pinecone Hosted Model Support Improvements
+  - Direct Text Search: Added full support for Pinecone indexes with integrated (hosted) embedding models. You can now perform semantic search using plain text queries—no local embedding required.
+  - Accurate Model Detection: The app now detects and displays the hosted model name (e.g., llama-text-embed-v2) in the info panel for Pinecone indexes.
+  - Robust Query Handling: The search logic now uses Pinecone’s search() API for hosted models, with correct response parsing and error handling.
+  - Future-Proof: Retained the ability to generate embeddings via Pinecone’s inference API for future features or advanced workflows.
+  - Improved Error Handling: Added better checks and debug logging for Pinecone API responses.
+  - These changes make Pinecone integration seamless and future-ready for both text and vector search scenarios.
 ---
 
 # Vector Inspector
@@ -40,7 +14,7 @@
 > **Disclaimer:** This tool is currently under active development and is **not production ready**. Not all features have been thoroughly tested and code is released frequently. Use with caution in critical or production environments.
 
 [![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)
-[![Publish](https://github.com/anthonypdawson/vector-inspector/actions/workflows/publish%20copy.yml/badge.svg?branch=master)](https://github.com/anthonypdawson/vector-inspector/actions/workflows/publish%20copy.yml)
+[![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)
 
 [![PyPI Version](https://img.shields.io/pypi/v/vector-inspector.svg?cacheSeconds=300)](https://pypi.org/project/vector-inspector/)
 [![PyPI Downloads](https://static.pepy.tech/personalized-badge/vector-inspector?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads)](https://pepy.tech/projects/vector-inspector)
@@ -48,6 +22,14 @@
 
 A comprehensive desktop application for visualizing, querying, and managing vector database data. Similar to SQL database viewers, Vector Inspector provides an intuitive GUI for exploring vector embeddings, metadata, and performing similarity searches across multiple vector database providers.
 
+<p align="center">
+  <a href="site/images/demo.gif" target="_blank">
+    <img src="site/images/demo.gif" alt="Vector Inspector Demo" width="600"/>
+  </a>
+</p>
+
+**Quick Demo:** See Vector Inspector in action!
+
 ## Overview
 
 Vector 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.

{vector_inspector-0.3.9 → vector_inspector-0.3.12}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "vector-inspector"
-version = "0.3.9"
+version = "0.3.12"
 description = "A comprehensive desktop application for visualizing, querying, and managing vector database data"
 authors = [
     { name = "Anthony Dawson", email = "anthonypdawson+github@gmail.com" },
@@ -23,10 +23,10 @@ dependencies = [
     "hf-xet>=1.2.0",
     "pymilvus>=2.6.6",
     "lancedb>=0.27.0",
-    "psycopg2>=2.9.11",
+    "psycopg2-binary>=2.9.11",
     "pgvector>=0.4.2",
 ]
-requires-python = ">=3.10,<3.14"
+requires-python = ">=3.10"
 readme = "README.md"
 
 [project.license]
@@ -55,6 +55,10 @@ dev = [
     "ruff>=0.14.14",
     "mypy>=1.19.1",
     "ipython>=8.18.0",
+    "briefcase>=0.3.26",
+    "pyarmor>=9.2.3",
+    "bumpver>=2025.1131",
+    "pyside6-stubs>=6.7.3.0",
 ]
 
 [tool.ruff]
@@ -92,6 +96,7 @@ select = [
 ignore = [
     "E501",
     "I001",
+    "UP045",
 ]
 
 [tool.ruff.lint.isort]
@@ -111,3 +116,67 @@ cmd = "python -m vector_inspector.main"
 
 [tool.pdm.scripts.vector-inspector.env]
 PYTHONPATH = "src"
+
+[tool.briefcase]
+project_name = "Vector Inspector"
+bundle = "com.divinedevops.vector-inspector"
+version = "0.3.12"
+url = "https://vector-inspector.divinedevops.com"
+author = "Anthony Dawson"
+author_email = "anthonypdawson+github@gmail.com"
+
+[tool.briefcase.license]
+file = "LICENSE"
+
+[tool.briefcase.app.vector-inspector]
+formal_name = "Vector Inspector"
+description = "A comprehensive desktop application for visualizing, querying, and managing vector database data"
+long_description = "More details about the app should go here.\n"
+sources = [
+    "src/vector_inspector",
+]
+test_sources = [
+    "tests",
+]
+requires = []
+test_requires = []
+
+[tool.briefcase.app.vector-inspector.macOS]
+universal_build = true
+requires = []
+
+[tool.briefcase.app.vector-inspector.linux]
+requires = []
+
+[tool.briefcase.app.vector-inspector.linux.system.debian]
+system_requires = []
+system_runtime_requires = []
+
+[tool.briefcase.app.vector-inspector.linux.system.rhel]
+system_requires = []
+system_runtime_requires = []
+
+[tool.briefcase.app.vector-inspector.linux.system.suse]
+system_requires = []
+system_runtime_requires = []
+
+[tool.briefcase.app.vector-inspector.linux.system.arch]
+system_requires = []
+system_runtime_requires = []
+
+[tool.briefcase.app.vector-inspector.linux.flatpak]
+flatpak_runtime = "org.freedesktop.Platform"
+flatpak_runtime_version = "25.08"
+flatpak_sdk = "org.freedesktop.Sdk"
+
+[tool.briefcase.app.vector-inspector.windows]
+requires = []
+
+[tool.briefcase.app.vector-inspector.iOS]
+requires = []
+
+[tool.briefcase.app.vector-inspector.android]
+requires = []
+
+[tool.briefcase.app.vector-inspector.web]
+requires = []

vector_inspector-0.3.12/src/vector_inspector/__init__.py

@@ -0,0 +1,12 @@
+"""Vector Inspector - A comprehensive desktop application for vector database visualization."""
+
+__version__ = "0.3.12"  # Keep in sync with pyproject.toml for dev mode fallback
+
+
+def get_version():
+    try:
+        from importlib.metadata import version, PackageNotFoundError
+
+        return version("vector-inspector")
+    except Exception:
+        return __version__

{vector_inspector-0.3.9 → vector_inspector-0.3.12}/src/vector_inspector/core/connection_manager.py

@@ -1,13 +1,15 @@
 """Connection manager for handling multiple vector database connections."""
 
 import uuid
-from typing import Dict, Optional, List, Any
 from enum import Enum
+from typing import Any
+
 from PySide6.QtCore import QObject, Signal
 
-from .connections.base_connection import VectorDBConnection
 from vector_inspector.core.logging import log_error
 
+from .connections.base_connection import VectorDBConnection
+
 
 class ConnectionState(Enum):
     """Possible connection states."""
@@ -27,7 +29,7 @@ class ConnectionInstance:
         name: str,
         provider: str,
         connection: VectorDBConnection,
-        config: Dict[str, Any],
+        config: dict[str, Any],
     ):
         """
         Initialize a connection instance.
@@ -42,12 +44,17 @@ class ConnectionInstance:
         self.id = connection_id
         self.name = name
         self.provider = provider
-        self.connection = connection
+        self.database = connection
         self.config = config
         self.state = ConnectionState.DISCONNECTED
-        self.active_collection: Optional[str] = None
-        self.collections: List[str] = []
-        self.error_message: Optional[str] = None
+        self.active_collection: str | None = None
+        self.collections: list[str] = []
+        self.error_message: str | None = None
+
+        # Set profile_name on the underlying connection object so it can be used
+        # for settings lookups (embedding models, etc.)
+        # Note: This dynamically adds an attribute to the connection object
+        self.database.profile_name = name  # type: ignore[attr-defined]
 
     def get_display_name(self) -> str:
         """Get a display-friendly connection name."""
@@ -59,6 +66,59 @@ class ConnectionInstance:
             return f"{self.name} > {self.active_collection}"
         return self.name
 
+    def __getattr__(self, name):
+        """Forward unknown attribute lookups to the underlying database connection.
+
+        This allows `ConnectionInstance` to act as a thin wrapper while
+        exposing the provider-specific API (e.g. `get_all_items`,
+        `query_collection`) without callers needing to access
+        `.database` explicitly.
+        """
+        return getattr(self.database, name)
+
+    # Convenience proxy methods to forward common operations to the underlying
+    # VectorDBConnection. This prevents callers from needing to access
+    # `instance.database` directly and centralizes error handling.
+    def list_collections(self) -> list[str]:
+        """Return list of collections from the underlying database connection.
+
+        Falls back to the cached `collections` attribute on error.
+        """
+        try:
+            return self.database.list_collections()
+        except Exception:
+            return self.collections or []
+
+    def connect(self) -> bool:
+        """Proxy to connect the underlying database connection."""
+        return self.database.connect()
+
+    def disconnect(self) -> None:
+        """Proxy to disconnect the underlying database connection; logs errors."""
+        try:
+            self.database.disconnect()
+        except Exception as e:
+            log_error("Error disconnecting underlying database: %s", e)
+
+    @property
+    def is_connected(self) -> bool:
+        """Whether the underlying database connection is currently connected."""
+        return getattr(self.database, "is_connected", False)
+
+    def get_collection_info(self, collection_name: str):
+        """Proxy to get collection-specific information."""
+        try:
+            return self.database.get_collection_info(collection_name)
+        except Exception:
+            return None
+
+    def delete_collection(self, collection_name: str) -> bool:
+        """Proxy to delete a collection on the underlying database connection."""
+        try:
+            return self.database.delete_collection(collection_name)
+        except Exception:
+            return False
+
 
 class ConnectionManager(QObject):
     """Manages multiple vector database connections and saved profiles.
@@ -85,16 +145,28 @@ class ConnectionManager(QObject):
     def __init__(self):
         """Initialize the connection manager."""
         super().__init__()
-        self._connections: Dict[str, ConnectionInstance] = {}
-        self._active_connection_id: Optional[str] = None
+        self._connections: dict[str, ConnectionInstance] = {}
+        self._active_connection_id: str | None = None
+
+    def get_active_collection(self) -> str | None:
+        """
+        Get the active collection name for the currently active connection.
+
+        Returns:
+            The active collection name, or None if no active connection or collection.
+        """
+        active_conn = self.get_active_connection()
+        if active_conn:
+            return active_conn.active_collection
+        return None
 
     def create_connection(
         self,
         name: str,
         provider: str,
         connection: VectorDBConnection,
-        config: Dict[str, Any],
-        connection_id: str = None,
+        config: dict[str, Any],
+        connection_id: str | None = None,
     ) -> str:
         """
         Create a new connection instance (not yet connected).
@@ -138,17 +210,17 @@ class ConnectionManager(QObject):
         if connection_id in self._connections:
             self.connection_opened.emit(connection_id)
 
-    def get_connection(self, connection_id: str) -> Optional[ConnectionInstance]:
+    def get_connection(self, connection_id: str) -> ConnectionInstance | None:
         """Get a connection instance by ID."""
         return self._connections.get(connection_id)
 
-    def get_active_connection(self) -> Optional[ConnectionInstance]:
+    def get_active_connection(self) -> ConnectionInstance | None:
         """Get the currently active connection instance."""
         if self._active_connection_id:
             return self._connections.get(self._active_connection_id)
         return None
 
-    def get_active_connection_id(self) -> Optional[str]:
+    def get_active_connection_id(self) -> str | None:
         """Get the currently active connection ID."""
         return self._active_connection_id
 
@@ -185,7 +257,7 @@ class ConnectionManager(QObject):
 
         # Disconnect the connection
         try:
-            instance.connection.disconnect()
+            instance.disconnect()
         except Exception as e:
             log_error("Error disconnecting: %s", e)
 
@@ -206,7 +278,7 @@ class ConnectionManager(QObject):
         return True
 
     def update_connection_state(
-        self, connection_id: str, state: ConnectionState, error: Optional[str] = None
+        self, connection_id: str, state: ConnectionState, error: str | None = None
     ):
         """
         Update the state of a connection.
@@ -225,7 +297,7 @@ class ConnectionManager(QObject):
                 instance.error_message = None
             self.connection_state_changed.emit(connection_id, state)
 
-    def update_collections(self, connection_id: str, collections: List[str]):
+    def update_collections(self, connection_id: str, collections: list[str]):
         """
         Update the collections list for a connection.
 
@@ -238,7 +310,7 @@ class ConnectionManager(QObject):
             instance.collections = collections
             self.collections_updated.emit(connection_id, collections)
 
-    def set_active_collection(self, connection_id: str, collection_name: Optional[str]):
+    def set_active_collection(self, connection_id: str, collection_name: str | None):
         """
         Set the active collection for a connection.
 
@@ -251,7 +323,7 @@ class ConnectionManager(QObject):
             instance.active_collection = collection_name
             self.active_collection_changed.emit(connection_id, collection_name)
 
-    def get_all_connections(self) -> List[ConnectionInstance]:
+    def get_all_connections(self) -> list[ConnectionInstance]:
         """Get list of all connection instances."""
         return list(self._connections.values())