vector-inspector 0.2.0__py3-none-any.whl → 0.2.1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: vector-inspector
3
- Version: 0.2.0
3
+ Version: 0.2.1
4
4
  Summary: A comprehensive desktop application for visualizing, querying, and managing vector database data
5
5
  Author-Email: Anthony Dawson <anthonypdawson+github@gmail.com>
6
6
  License: MIT
@@ -33,9 +33,9 @@ A comprehensive desktop application for visualizing, querying, and managing vect
33
33
  - [Architecture](#architecture)
34
34
  - [Application Structure](#application-structure)
35
35
  - [Use Cases](#use-cases)
36
- - [Feature Access (Free vs Pro)](#feature-access-free-vs-pro)
37
- - [Planned Roadmap](#planned-roadmap)
38
- - [Installation (Planned)](#installation-planned)
36
+ - [Feature Access](#feature-access)
37
+ - [Roadmap](#roadmap)
38
+ - [Installation](#installation)
39
39
  - [Configuration](#configuration)
40
40
  - [Development Setup](#development-setup)
41
41
  - [Contributing](#contributing)
@@ -119,58 +119,9 @@ Vector Inspector bridges the gap between vector databases and user-friendly data
119
119
 
120
120
  ## Architecture
121
121
 
122
- ### Technology Stack
123
-
124
- #### Frontend (GUI)
125
- - **Framework**: PySide6 (Qt for Python) - native desktop application
126
- - **UI Components**: Qt Widgets for forms, dialogs, and application structure
127
- - **Visualization**:
128
- - Plotly for interactive charts (embedded via QWebEngineView)
129
- - matplotlib for static visualizations
130
- - **Data Grid**: QTableView with custom models for high-performance data display
131
-
132
- #### Backend
133
- - **Language**: Python 3.12
134
- - **Core Libraries**:
135
- - Vector DB clients: `chromadb`, `qdrant-client` (implemented), `pinecone-client`, `weaviate-client`, `pymilvus` (planned)
136
- - Embeddings: `sentence-transformers`, `fastembed` (implemented), `openai`, `cohere` (planned)
137
- - Data processing: `pandas`, `numpy`
138
- - Dimensionality reduction: `scikit-learn`, `umap-learn`
139
- - **API Layer**: FastAPI (planned for programmatic access) or direct Python integration
140
-
141
- #### Data Layer
142
- - **Connection Management**: Provider-specific connection classes with unified interface
143
- - **Query Abstraction**: Base connection interface that each provider implements
144
- - **Storage Modes**:
145
- - ChromaDB: Persistent local storage
146
- - Qdrant Remote: Connect via host/port (e.g., localhost:6333)
147
- - Qdrant Embedded: Local path storage without separate server
148
- - **Caching**: Redis or in-memory cache for frequently accessed data (planned)
149
- - **Settings Persistence**: User settings saved to ~/.vector-viewer/settings.json
150
-
151
- ### Application Structure
122
+ Vector 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.
152
123
 
153
- ```
154
- vector-viewer/
155
- ├── src/
156
- │ └── vector_viewer/
157
- │ ├── core/
158
- │ │ └── connections/ # Connection managers for each provider
159
- │ ├── ui/
160
- │ │ ├── components/ # Reusable UI components
161
- │ │ └── views/ # Main application views
162
- │ ├── services/ # Business logic services
163
- │ └── main.py # Application entry point
164
- ├── tests/
165
- ├── docs/
166
- ├── data/ # Local database storage
167
- │ ├── chroma_db/
168
- │ └── qdrant/
169
- ├── run.sh / run.bat # Launch scripts
170
- └── pyproject.toml
171
- ```
172
-
173
- User settings are saved to `~/.vector-viewer/settings.json`
124
+ For detailed architecture information, see [docs/architecture.md](docs/architecture.md).
174
125
 
175
126
  ## Use Cases
176
127
 
@@ -181,116 +132,29 @@ User settings are saved to `~/.vector-viewer/settings.json`
181
132
  5. **Data Migration**: Transfer data between vector database providers
182
133
  6. **Education**: Learn and experiment with vector databases interactively
183
134
 
184
- ## Feature Access (Free vs Pro)
185
-
186
- | Feature | Access |
187
- |----------------------------------------------|----------|
188
- | Connection to ChromaDB | Free |
189
- | Basic metadata browsing and filtering | Free |
190
- | Simple similarity search interface | Free |
191
- | 2D vector visualization (PCA/t-SNE) | Free |
192
- | Basic CRUD operations | Free |
193
- | Metadata filtering (advanced) | Free |
194
- | Item editing | Free |
195
- | Import/export (CSV, JSON, Parquet) | Free |
196
- | Provider abstraction layer | Free |
197
- | Pinecone support | Free |
198
- | Weaviate support | Free |
199
- | Qdrant support (basic/experimental) | Free |
200
- | Milvus support | Pro |
201
- | ChromaDB advanced support | Pro |
202
- | FAISS (local files) support | Pro |
203
- | pgvector (PostgreSQL extension) support | Pro |
204
- | Elasticsearch with vector search support | Pro |
205
- | Advanced query builder | Free |
206
- | 3D visualization | Free |
207
- | Embedding model integration (basic) | Free |
208
- | Query history and saved queries | Free |
209
- | Model Comparison Mode | Pro |
210
- | Cluster Explorer | Pro |
211
- | Embedding Inspector | Pro |
212
- | Embedding Provenance Graph | Pro |
213
- | Semantic Drift Timeline | Pro |
214
- | Cross-Collection Similarity | Pro |
215
- | Vector Surgery | Pro |
216
- | Custom plugin system | Pro |
217
- | Team collaboration features | Pro |
218
-
219
- > **Note:** Qdrant support is available for free users in the open source version (basic/experimental). Advanced Qdrant features (e.g., payload filtering, geo, cloud auth) may be reserved for Pro in the future.
220
-
221
- ## Planned Roadmap
222
-
223
- ### Phase 1: Foundation (MVP)
224
- - [x] Connection to ChromaDB
225
- - [x] Basic metadata browsing and filtering
226
- - [x] Simple similarity search interface
227
- - [x] 2D vector visualization (PCA/t-SNE)
228
- - [x] Basic CRUD operations
229
-
230
- ### Phase 2: Core Features
231
- - [x] Metadata filtering (advanced filtering, combine with search)
232
- - [x] Item editing (update metadata and documents)
233
- - [x] Import/export (CSV, JSON, Parquet, backup/restore)
234
- - [x] Provider abstraction layer (unified interface for all supported vector DBs)
235
- - [x] Qdrant support (basic/experimental, free)
236
-
237
- ### Phase 3: UX & Professional Polish
238
- - [ ] **Unified Information Panel** (new "Info" tab as default view)
239
- - [ ] Database and collection metadata display
240
- - [ ] Connection health and version information
241
- - [ ] Schema visualization and index configuration display
242
-
243
- ### Phase 4: Modular/Plugin System & Hybrid Model
244
- - [ ] Implement modular/plugin system for feature extensions
245
- - [ ] Migrate paid/advanced features to commercial modules
246
- - [ ] Add licensing/access control for commercial features
247
-
248
- ### Phase 5: Provider Expansion (Incremental)
249
- - [ ] Pinecone support (free)
250
- - [ ] Weaviate support (free)
251
- - [ ] Qdrant support (paid)
252
-
253
- #### Future/Backlog Providers
254
- - [ ] Milvus support (paid)
255
- - [ ] ChromaDB advanced support (paid)
256
- - [ ] FAISS (local files) support (paid)
257
- - [ ] pgvector (PostgreSQL extension) support (paid)
258
- - [ ] Elasticsearch with vector search support (paid)
259
-
260
-
261
- ### Phase 6A: Advanced Usability & Visualization
262
- - [ ] Advanced query builder (free)
263
- - [ ] 3D visualization (free)
264
- - [ ] Embedding model integration (free)
265
- - [ ] Query history and saved queries (free)
266
- - [ ] Metadata Type Detection & Rich Media Preview (free)
267
-
268
- ### Phase 6B: Analytical & Comparison Tools
269
- - [ ] Model Comparison Mode (paid)
270
- - [ ] Cluster Explorer (paid)
271
- - [ ] Embedding Inspector (paid)
272
- - [ ] Embedding Provenance Graph (paid)
273
-
274
- ### Phase 6C: Temporal & Cross-Collection Analytics
275
- - [ ] Semantic Drift Timeline (paid)
276
- - [ ] Cross-Collection Similarity (paid)
277
-
278
- ### Phase 6D: Experimental & Power Features
279
- - [ ] Vector Surgery (paid)
280
- - [ ] Custom plugin system (paid)
281
- - [ ] Team collaboration features (paid)
282
-
283
- ### Phase 7: Enterprise Features
284
- - [ ] Multi-user support with auth
285
- - [ ] Audit logging
286
- - [ ] Advanced security features
287
- - [ ] Custom reporting
288
- - [ ] API for programmatic access (FastAPI backend)
289
- - [ ] Caching layer (Redis/in-memory) for performance
290
- - [ ] Connection pooling and optimization
135
+ ## Feature Access
136
+
137
+ Vector Inspector is available in both free (open source) and Pro versions. The free version includes all core features for ChromaDB and basic Qdrant support, while Pro adds advanced analytics and additional providers.
138
+
139
+ See [FEATURES.md](FEATURES.md) for a complete feature comparison.
140
+
141
+ ## Roadmap
142
+
143
+ **Current Status**: Phase 2 Complete
144
+
145
+ See [ROADMAP.md](ROADMAP.md) for the complete development roadmap and planned features.
291
146
 
292
147
  ## Installation
293
148
 
149
+ ### From PyPI (Recommended)
150
+
151
+ ```bash
152
+ pip install vector-inspector
153
+ vector-inspector
154
+ ```
155
+
156
+ ### From Source
157
+
294
158
  ```bash
295
159
  # Clone the repository
296
160
  git clone https://github.com/anthonypdawson/vector-viewer.git
@@ -1,6 +1,6 @@
1
- vector_inspector-0.2.0.dist-info/METADATA,sha256=HQuVCvuWJ6B4AR6QX8EQDc8nV6F0PjLTeSRjzJN8t00,14669
2
- vector_inspector-0.2.0.dist-info/WHEEL,sha256=tsUv_t7BDeJeRHaSrczbGeuK-TtDpGsWi_JfpzD255I,90
3
- vector_inspector-0.2.0.dist-info/entry_points.txt,sha256=u96envMI2NFImZUJDFutiiWl7ZoHrrev9joAgtyvTxo,80
1
+ vector_inspector-0.2.1.dist-info/METADATA,sha256=QqrDwhDHEWhC5-t2yWbplCVCxYc7Xk_qFwVrZMDKeSw,8659
2
+ vector_inspector-0.2.1.dist-info/WHEEL,sha256=tsUv_t7BDeJeRHaSrczbGeuK-TtDpGsWi_JfpzD255I,90
3
+ vector_inspector-0.2.1.dist-info/entry_points.txt,sha256=u96envMI2NFImZUJDFutiiWl7ZoHrrev9joAgtyvTxo,80
4
4
  vector_inspector/__init__.py,sha256=Q8XbXn98o0eliQWPePhy-aGUz2KNnVg7bQq-sBPl7zQ,119
5
5
  vector_inspector/__main__.py,sha256=Vdhw8YA1K3wPMlbJQYL5WqvRzAKVeZ16mZQFO9VRmCo,62
6
6
  vector_inspector/core/__init__.py,sha256=hjOqiJwF1P0rXjiOKhK4qDTvBY7G3m4kq8taH-gKrFM,57
@@ -29,4 +29,4 @@ vector_inspector/ui/views/connection_view.py,sha256=5TL28JMfb0W42eUDDNbj6bIaj6m7
29
29
  vector_inspector/ui/views/metadata_view.py,sha256=1prg0ZFkPbA2PxUzr5Z-WlW8nTXa-_WSNlLIU-RTLME,21286
30
30
  vector_inspector/ui/views/search_view.py,sha256=p6vt2heSpEbiRge46VSedTZjg7i3-AWdS0f96JXzlEU,10527
31
31
  vector_inspector/ui/views/visualization_view.py,sha256=389lKOOqz4_7I-pUIIu86ZbA2ttq8Tuwflbb5W-W4g0,9038
32
- vector_inspector-0.2.0.dist-info/RECORD,,
32
+ vector_inspector-0.2.1.dist-info/RECORD,,