vectorizer-sdk 1.0.1__tar.gz → 1.3.0__tar.gz

vectorizer_sdk-1.3.0/LICENSE

@@ -0,0 +1,191 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+   "License" shall mean the terms and conditions for use, reproduction,
+   and distribution as defined by Sections 1 through 9 of this document.
+
+   "Licensor" shall mean the copyright owner or entity authorized by
+   the copyright owner that is granting the License.
+
+   "Legal Entity" shall mean the union of the acting entity and all
+   other entities that control, are controlled by, or are under common
+   control with that entity. For the purposes of this definition,
+   "control" means (i) the power, direct or indirect, to cause the
+   direction or management of such entity, whether by contract or
+   otherwise, or (ii) ownership of fifty percent (50%) or more of the
+   outstanding shares, or (iii) beneficial ownership of such entity.
+
+   "You" (or "Your") shall mean an individual or Legal Entity
+   exercising permissions granted by this License.
+
+   "Source" form shall mean the preferred form for making modifications,
+   including but not limited to software source code, documentation
+   source, and configuration files.
+
+   "Object" form shall mean any form resulting from mechanical
+   transformation or translation of a Source form, including but
+   not limited to compiled object code, generated documentation,
+   and conversions to other media types.
+
+   "Work" shall mean the work of authorship, whether in Source or
+   Object form, made available under the License, as indicated by a
+   copyright notice that is included in or attached to the work (which
+   shall not include Communications that are clearly marked or
+   otherwise designated in writing by the copyright owner as "Not a Work").
+
+   "Derivative Works" shall mean any work, whether in Source or Object
+   form, that is based on (or derived from) the Work and for which the
+   editorial revisions, annotations, elaborations, or other modifications
+   represent, as a whole, an original work of authorship. For the purposes
+   of this License, Derivative Works shall not include works that remain
+   separable from, or merely link (or bind by name) to the interfaces of,
+   the Work and Derivative Works thereof.
+
+   "Contribution" shall mean any work of authorship, including
+   the original version of the Work and any modifications or additions
+   to that Work or Derivative Works thereof, that is intentionally
+   submitted to Licensor for inclusion in the Work by the copyright owner
+   or by an individual or Legal Entity authorized to submit on behalf of
+   the copyright owner. For the purposes of this definition, "submitted"
+   means any form of electronic, verbal, or written communication sent
+   to the Licensor or its representatives, including but not limited to
+   communication on electronic mailing lists, source code control systems,
+   and issue tracking systems that are managed by, or on behalf of, the
+   Licensor for the purpose of discussing and improving the Work, but
+   excluding communication that is conspicuously marked or otherwise
+   designated in writing by the copyright owner as "Not a Contribution."
+
+   "Contributor" shall mean Licensor and any individual or Legal Entity
+   on behalf of whom a Contribution has been received by Licensor and
+   subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   copyright license to reproduce, prepare Derivative Works of,
+   publicly display, publicly perform, sublicense, and distribute the
+   Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   (except as stated in this section) patent license to make, have made,
+   use, offer to sell, sell, import, and otherwise transfer the Work,
+   where such license applies only to those patent claims licensable
+   by such Contributor that are necessarily infringed by their
+   Contribution(s) alone or by combination of their Contribution(s)
+   with the Work to which such Contribution(s) was submitted. If You
+   institute patent litigation against any entity (including a
+   cross-claim or counterclaim in a lawsuit) alleging that the Work
+   or a Contribution incorporated within the Work constitutes direct
+   or contributory patent infringement, then any patent licenses
+   granted to You under this License for that Work shall terminate
+   as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+   Work or Derivative Works thereof in any medium, with or without
+   modifications, and in Source or Object form, provided that You
+   meet the following conditions:
+
+   (a) You must give any other recipients of the Work or
+       Derivative Works a copy of this License; and
+
+   (b) You must cause any modified files to carry prominent notices
+       stating that You changed the files; and
+
+   (c) You must retain, in the Source form of any Derivative Works
+       that You distribute, all copyright, patent, trademark, and
+       attribution notices from the Source form of the Work,
+       excluding those notices that do not pertain to any part of
+       the Derivative Works; and
+
+   (d) If the Work includes a "NOTICE" text file as part of its
+       distribution, then any Derivative Works that You distribute must
+       include a readable copy of the attribution notices contained
+       within such NOTICE file, excluding those notices that do not
+       pertain to any part of the Derivative Works, in at least one
+       of the following places: within a NOTICE text file distributed
+       as part of the Derivative Works; within the Source form or
+       documentation, if provided along with the Derivative Works; or,
+       within a display generated by the Derivative Works, if and
+       wherever such third-party notices normally appear. The contents
+       of the NOTICE file are for informational purposes only and do
+       not modify the License. You may add Your own attribution notices
+       within Derivative Works that You distribute, alongside or as an
+       addendum to the NOTICE text from the Work, provided that such
+       additional attribution notices cannot be construed as modifying
+       the License.
+
+   You may add Your own copyright statement to Your modifications and
+   may provide additional or different license terms and conditions for
+   use, reproduction, or distribution of Your modifications, or for any
+   such Derivative Works as a whole, provided Your use, reproduction,
+   and distribution of the Work otherwise complies with the conditions
+   stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+   any Contribution intentionally submitted for inclusion in the Work
+   by You to the Licensor shall be under the terms and conditions of
+   this License, without any additional terms or conditions.
+   Notwithstanding the above, nothing herein shall supersede or modify
+   the terms of any separate license agreement you may have executed
+   with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+   names, trademarks, service marks, or product names of the Licensor,
+   except as required for reasonable and customary use in describing the
+   origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+   agreed to in writing, Licensor provides the Work (and each
+   Contributor provides its Contributions) on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+   implied, including, without limitation, any warranties or conditions
+   of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+   PARTICULAR PURPOSE. You are solely responsible for determining the
+   appropriateness of using or redistributing the Work and assume any
+   risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+   whether in tort (including negligence), contract, or otherwise,
+   unless required by applicable law (such as deliberate and grossly
+   negligent acts) or agreed to in writing, shall any Contributor be
+   liable to You for damages, including any direct, indirect, special,
+   incidental, or consequential damages of any character arising as a
+   result of this License or out of the use or inability to use the
+   Work (including but not limited to damages for loss of goodwill,
+   work stoppage, computer failure or malfunction, or any and all
+   other commercial damages or losses), even if such Contributor
+   has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+   the Work or Derivative Works thereof, You may choose to offer,
+   and charge a fee for, acceptance of support, warranty, indemnity,
+   or other liability obligations and/or rights consistent with this
+   License. However, in accepting such obligations, You may act only
+   on Your own behalf and on Your sole responsibility, not on behalf
+   of any other Contributor, and only if You agree to indemnify,
+   defend, and hold each Contributor harmless for any liability
+   incurred by, or claims asserted against, such Contributor by reason
+   of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+Copyright 2024 HiveLLM Contributors
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

{vectorizer_sdk-1.0.1/vectorizer_sdk.egg-info → vectorizer_sdk-1.3.0}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: vectorizer_sdk
-Version: 1.0.1
+Version: 1.3.0
 Summary: Python SDK for Vectorizer - Semantic search and vector operations with UMICP protocol support
 Author-email: HiveLLM Team <team@hivellm.org>
-License-Expression: MIT
+License-Expression: Apache-2.0
 Project-URL: Homepage, https://github.com/hivellm/vectorizer
 Project-URL: Documentation, https://github.com/hivellm/vectorizer/tree/main/docs
 Project-URL: Repository, https://github.com/hivellm/vectorizer
@@ -47,20 +47,30 @@ Requires-Dist: pytest-cov>=4.0.0; extra == "test"
 Requires-Dist: httpx>=0.24.0; extra == "test"
 Dynamic: license-file
 
-# Hive Vectorizer Python SDK
+# Vectorizer Python SDK
 
-A comprehensive Python client library for the Hive Vectorizer service.
+[![PyPI version](https://badge.fury.io/py/vectorizer-sdk.svg)](https://pypi.org/project/vectorizer-sdk/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/vectorizer-sdk.svg)](https://pypi.org/project/vectorizer-sdk/)
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
+
+A comprehensive Python SDK for the Vectorizer semantic search service.
+
+**Package**: `vectorizer_sdk` (PEP 625 compliant)  
+**Version**: 1.3.0  
+**PyPI**: https://pypi.org/project/vectorizer-sdk/
 
 ## Features
 
 - **Multiple Transport Protocols**: HTTP/HTTPS and UMICP support
-- **UMICP Protocol**: High-performance protocol using umicp-python package
+- **UMICP Protocol**: High-performance protocol using umicp-sdk package (v0.3.2+)
 - **Vector Operations**: Insert, search, and manage vectors
-- **Collection Management**: Create, delete, and monitor collections  
+- **Collection Management**: Create, delete, and monitor collections
 - **Semantic Search**: Find similar content using embeddings
 - **Intelligent Search**: Advanced multi-query search with domain expansion
 - **Contextual Search**: Context-aware search with metadata filtering
 - **Multi-Collection Search**: Cross-collection search with intelligent aggregation
+- **Hybrid Search**: Combine dense and sparse vectors for improved search quality
+- **Qdrant Compatibility**: Full Qdrant REST API compatibility for easy migration
 - **Batch Operations**: Efficient bulk operations
 - **Error Handling**: Comprehensive exception handling
 - **Async Support**: Full async/await support for high performance
@@ -69,7 +79,11 @@ A comprehensive Python client library for the Hive Vectorizer service.
 ## Installation
 
 ```bash
+# Install from PyPI
 pip install vectorizer-sdk
+
+# Or specific version
+pip install vectorizer-sdk==1.3.0
 ```
 
 ## Quick Start
@@ -82,31 +96,31 @@ async def main():
     async with VectorizerClient() as client:
         # Create a collection
         await client.create_collection("my_collection", dimension=512)
-        
+
         # Generate embedding
         embedding = await client.embed_text("Hello, world!")
-        
+
         # Create vector
         vector = Vector(
             id="doc1",
             data=embedding,
             metadata={"text": "Hello, world!"}
         )
-        
+
         # Insert text
         await client.insert_texts("my_collection", [{
             "id": "doc1",
             "text": "Hello, world!",
             "metadata": {"source": "example"}
         }])
-        
+
         # Search for similar vectors
         results = await client.search_vectors(
             collection="my_collection",
             query="greeting",
             limit=5
         )
-        
+
         # Intelligent search with multi-query expansion
         from models import IntelligentSearchRequest
         intelligent_results = await client.intelligent_search(
@@ -120,7 +134,7 @@ async def main():
                 mmr_lambda=0.7
             )
         )
-        
+
         # Semantic search with reranking
         from models import SemanticSearchRequest
         semantic_results = await client.semantic_search(
@@ -132,7 +146,7 @@ async def main():
                 similarity_threshold=0.6
             )
         )
-        
+
         # Contextual search with metadata filtering
         from models import ContextualSearchRequest
         contextual_results = await client.contextual_search(
@@ -144,7 +158,7 @@ async def main():
                 context_weight=0.4
             )
         )
-        
+
         # Multi-collection search
         from models import MultiCollectionSearchRequest
         multi_results = await client.multi_collection_search(
@@ -156,8 +170,43 @@ async def main():
                 cross_collection_reranking=True
             )
         )
-        
-        print(f"Found {len(results)} similar vectors")
+
+        # Hybrid search (dense + sparse vectors)
+        from models import HybridSearchRequest, SparseVector
+
+        sparse_query = SparseVector(
+            indices=[0, 5, 10, 15],
+            values=[0.8, 0.6, 0.9, 0.7]
+        )
+
+        hybrid_results = await client.hybrid_search(
+            HybridSearchRequest(
+                collection="my_collection",
+                query="search query",
+                query_sparse=sparse_query,
+                alpha=0.7,
+                algorithm="rrf",  # "rrf", "weighted", or "alpha"
+                dense_k=20,
+                sparse_k=20,
+                final_k=10
+            )
+        )
+
+        print(f"Found {len(hybrid_results.results)} similar vectors")
+
+        # Qdrant-compatible API usage
+        # List collections
+        qdrant_collections = await client.qdrant_list_collections()
+        print(f"Qdrant collections: {qdrant_collections}")
+
+        # Search points (Qdrant format)
+        qdrant_results = await client.qdrant_search_points(
+            collection="my_collection",
+            vector=embedding,
+            limit=10,
+            with_payload=True
+        )
+        print(f"Qdrant search results: {qdrant_results}")
 
 asyncio.run(main())
 ```
@@ -213,24 +262,26 @@ client = VectorizerClient(
 #### When to Use UMICP
 
 Use UMICP when:
+
 - **Large Payloads**: Inserting or searching large batches of vectors
 - **High Throughput**: Need maximum performance for production workloads
 - **Low Latency**: Need minimal protocol overhead
 
 Use HTTP when:
+
 - **Development**: Quick testing and debugging
 - **Firewall Restrictions**: Only HTTP/HTTPS allowed
 - **Simple Deployments**: No need for custom protocol setup
 
 #### Protocol Comparison
 
-| Feature | HTTP/HTTPS | UMICP |
-|---------|-----------|-------|
-| Transport | aiohttp (standard HTTP) | umicp-python package |
-| Performance | Standard | Optimized for large payloads |
-| Latency | Standard | Lower overhead |
-| Firewall | Widely supported | May require configuration |
-| Installation | Default | Requires umicp-python |
+| Feature      | HTTP/HTTPS              | UMICP                        |
+| ------------ | ----------------------- | ---------------------------- |
+| Transport    | aiohttp (standard HTTP) | umicp-python package         |
+| Performance  | Standard                | Optimized for large payloads |
+| Latency      | Standard                | Lower overhead               |
+| Firewall     | Widely supported        | May require configuration    |
+| Installation | Default                 | Requires umicp-python        |
 
 #### Installing with UMICP Support
 

{vectorizer_sdk-1.0.1 → vectorizer_sdk-1.3.0}/README.md

@@ -1,17 +1,27 @@
-# Hive Vectorizer Python SDK
+# Vectorizer Python SDK
 
-A comprehensive Python client library for the Hive Vectorizer service.
+[![PyPI version](https://badge.fury.io/py/vectorizer-sdk.svg)](https://pypi.org/project/vectorizer-sdk/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/vectorizer-sdk.svg)](https://pypi.org/project/vectorizer-sdk/)
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
+
+A comprehensive Python SDK for the Vectorizer semantic search service.
+
+**Package**: `vectorizer_sdk` (PEP 625 compliant)  
+**Version**: 1.3.0  
+**PyPI**: https://pypi.org/project/vectorizer-sdk/
 
 ## Features
 
 - **Multiple Transport Protocols**: HTTP/HTTPS and UMICP support
-- **UMICP Protocol**: High-performance protocol using umicp-python package
+- **UMICP Protocol**: High-performance protocol using umicp-sdk package (v0.3.2+)
 - **Vector Operations**: Insert, search, and manage vectors
-- **Collection Management**: Create, delete, and monitor collections  
+- **Collection Management**: Create, delete, and monitor collections
 - **Semantic Search**: Find similar content using embeddings
 - **Intelligent Search**: Advanced multi-query search with domain expansion
 - **Contextual Search**: Context-aware search with metadata filtering
 - **Multi-Collection Search**: Cross-collection search with intelligent aggregation
+- **Hybrid Search**: Combine dense and sparse vectors for improved search quality
+- **Qdrant Compatibility**: Full Qdrant REST API compatibility for easy migration
 - **Batch Operations**: Efficient bulk operations
 - **Error Handling**: Comprehensive exception handling
 - **Async Support**: Full async/await support for high performance
@@ -20,7 +30,11 @@ A comprehensive Python client library for the Hive Vectorizer service.
 ## Installation
 
 ```bash
+# Install from PyPI
 pip install vectorizer-sdk
+
+# Or specific version
+pip install vectorizer-sdk==1.3.0
 ```
 
 ## Quick Start
@@ -33,31 +47,31 @@ async def main():
     async with VectorizerClient() as client:
         # Create a collection
         await client.create_collection("my_collection", dimension=512)
-        
+
         # Generate embedding
         embedding = await client.embed_text("Hello, world!")
-        
+
         # Create vector
         vector = Vector(
             id="doc1",
             data=embedding,
             metadata={"text": "Hello, world!"}
         )
-        
+
         # Insert text
         await client.insert_texts("my_collection", [{
             "id": "doc1",
             "text": "Hello, world!",
             "metadata": {"source": "example"}
         }])
-        
+
         # Search for similar vectors
         results = await client.search_vectors(
             collection="my_collection",
             query="greeting",
             limit=5
         )
-        
+
         # Intelligent search with multi-query expansion
         from models import IntelligentSearchRequest
         intelligent_results = await client.intelligent_search(
@@ -71,7 +85,7 @@ async def main():
                 mmr_lambda=0.7
             )
         )
-        
+
         # Semantic search with reranking
         from models import SemanticSearchRequest
         semantic_results = await client.semantic_search(
@@ -83,7 +97,7 @@ async def main():
                 similarity_threshold=0.6
             )
         )
-        
+
         # Contextual search with metadata filtering
         from models import ContextualSearchRequest
         contextual_results = await client.contextual_search(
@@ -95,7 +109,7 @@ async def main():
                 context_weight=0.4
             )
         )
-        
+
         # Multi-collection search
         from models import MultiCollectionSearchRequest
         multi_results = await client.multi_collection_search(
@@ -107,8 +121,43 @@ async def main():
                 cross_collection_reranking=True
             )
         )
-        
-        print(f"Found {len(results)} similar vectors")
+
+        # Hybrid search (dense + sparse vectors)
+        from models import HybridSearchRequest, SparseVector
+
+        sparse_query = SparseVector(
+            indices=[0, 5, 10, 15],
+            values=[0.8, 0.6, 0.9, 0.7]
+        )
+
+        hybrid_results = await client.hybrid_search(
+            HybridSearchRequest(
+                collection="my_collection",
+                query="search query",
+                query_sparse=sparse_query,
+                alpha=0.7,
+                algorithm="rrf",  # "rrf", "weighted", or "alpha"
+                dense_k=20,
+                sparse_k=20,
+                final_k=10
+            )
+        )
+
+        print(f"Found {len(hybrid_results.results)} similar vectors")
+
+        # Qdrant-compatible API usage
+        # List collections
+        qdrant_collections = await client.qdrant_list_collections()
+        print(f"Qdrant collections: {qdrant_collections}")
+
+        # Search points (Qdrant format)
+        qdrant_results = await client.qdrant_search_points(
+            collection="my_collection",
+            vector=embedding,
+            limit=10,
+            with_payload=True
+        )
+        print(f"Qdrant search results: {qdrant_results}")
 
 asyncio.run(main())
 ```
@@ -164,24 +213,26 @@ client = VectorizerClient(
 #### When to Use UMICP
 
 Use UMICP when:
+
 - **Large Payloads**: Inserting or searching large batches of vectors
 - **High Throughput**: Need maximum performance for production workloads
 - **Low Latency**: Need minimal protocol overhead
 
 Use HTTP when:
+
 - **Development**: Quick testing and debugging
 - **Firewall Restrictions**: Only HTTP/HTTPS allowed
 - **Simple Deployments**: No need for custom protocol setup
 
 #### Protocol Comparison
 
-| Feature | HTTP/HTTPS | UMICP |
-|---------|-----------|-------|
-| Transport | aiohttp (standard HTTP) | umicp-python package |
-| Performance | Standard | Optimized for large payloads |
-| Latency | Standard | Lower overhead |
-| Firewall | Widely supported | May require configuration |
-| Installation | Default | Requires umicp-python |
+| Feature      | HTTP/HTTPS              | UMICP                        |
+| ------------ | ----------------------- | ---------------------------- |
+| Transport    | aiohttp (standard HTTP) | umicp-python package         |
+| Performance  | Standard                | Optimized for large payloads |
+| Latency      | Standard                | Lower overhead               |
+| Firewall     | Widely supported        | May require configuration    |
+| Installation | Default                 | Requires umicp-python        |
 
 #### Installing with UMICP Support
 
@@ -252,4 +303,4 @@ MIT License - see LICENSE file for details.
 ## Support
 
 - GitHub Issues: https://github.com/cmmv-hive/vectorizer/issues
-- Email: team@hivellm.org
+- Email: team@hivellm.org

{vectorizer_sdk-1.0.1 → vectorizer_sdk-1.3.0}/pyproject.toml

@@ -4,11 +4,11 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "vectorizer_sdk"
-version = "1.0.1"
+version = "1.3.0"
 description = "Python SDK for Vectorizer - Semantic search and vector operations with UMICP protocol support"
 readme = "README.md"
 requires-python = ">=3.8"
-license = "MIT"
+license = "Apache-2.0"
 authors = [
     {name = "HiveLLM Team", email = "team@hivellm.org"}
 ]

{vectorizer_sdk-1.0.1 → vectorizer_sdk-1.3.0/vectorizer_sdk.egg-info}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: vectorizer_sdk
-Version: 1.0.1
+Version: 1.3.0
 Summary: Python SDK for Vectorizer - Semantic search and vector operations with UMICP protocol support
 Author-email: HiveLLM Team <team@hivellm.org>
-License-Expression: MIT
+License-Expression: Apache-2.0
 Project-URL: Homepage, https://github.com/hivellm/vectorizer
 Project-URL: Documentation, https://github.com/hivellm/vectorizer/tree/main/docs
 Project-URL: Repository, https://github.com/hivellm/vectorizer
@@ -47,20 +47,30 @@ Requires-Dist: pytest-cov>=4.0.0; extra == "test"
 Requires-Dist: httpx>=0.24.0; extra == "test"
 Dynamic: license-file
 
-# Hive Vectorizer Python SDK
+# Vectorizer Python SDK
 
-A comprehensive Python client library for the Hive Vectorizer service.
+[![PyPI version](https://badge.fury.io/py/vectorizer-sdk.svg)](https://pypi.org/project/vectorizer-sdk/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/vectorizer-sdk.svg)](https://pypi.org/project/vectorizer-sdk/)
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
+
+A comprehensive Python SDK for the Vectorizer semantic search service.
+
+**Package**: `vectorizer_sdk` (PEP 625 compliant)  
+**Version**: 1.3.0  
+**PyPI**: https://pypi.org/project/vectorizer-sdk/
 
 ## Features
 
 - **Multiple Transport Protocols**: HTTP/HTTPS and UMICP support
-- **UMICP Protocol**: High-performance protocol using umicp-python package
+- **UMICP Protocol**: High-performance protocol using umicp-sdk package (v0.3.2+)
 - **Vector Operations**: Insert, search, and manage vectors
-- **Collection Management**: Create, delete, and monitor collections  
+- **Collection Management**: Create, delete, and monitor collections
 - **Semantic Search**: Find similar content using embeddings
 - **Intelligent Search**: Advanced multi-query search with domain expansion
 - **Contextual Search**: Context-aware search with metadata filtering
 - **Multi-Collection Search**: Cross-collection search with intelligent aggregation
+- **Hybrid Search**: Combine dense and sparse vectors for improved search quality
+- **Qdrant Compatibility**: Full Qdrant REST API compatibility for easy migration
 - **Batch Operations**: Efficient bulk operations
 - **Error Handling**: Comprehensive exception handling
 - **Async Support**: Full async/await support for high performance
@@ -69,7 +79,11 @@ A comprehensive Python client library for the Hive Vectorizer service.
 ## Installation
 
 ```bash
+# Install from PyPI
 pip install vectorizer-sdk
+
+# Or specific version
+pip install vectorizer-sdk==1.3.0
 ```
 
 ## Quick Start
@@ -82,31 +96,31 @@ async def main():
     async with VectorizerClient() as client:
         # Create a collection
         await client.create_collection("my_collection", dimension=512)
-        
+
         # Generate embedding
         embedding = await client.embed_text("Hello, world!")
-        
+
         # Create vector
         vector = Vector(
             id="doc1",
             data=embedding,
             metadata={"text": "Hello, world!"}
         )
-        
+
         # Insert text
         await client.insert_texts("my_collection", [{
             "id": "doc1",
             "text": "Hello, world!",
             "metadata": {"source": "example"}
         }])
-        
+
         # Search for similar vectors
         results = await client.search_vectors(
             collection="my_collection",
             query="greeting",
             limit=5
         )
-        
+
         # Intelligent search with multi-query expansion
         from models import IntelligentSearchRequest
         intelligent_results = await client.intelligent_search(
@@ -120,7 +134,7 @@ async def main():
                 mmr_lambda=0.7
             )
         )
-        
+
         # Semantic search with reranking
         from models import SemanticSearchRequest
         semantic_results = await client.semantic_search(
@@ -132,7 +146,7 @@ async def main():
                 similarity_threshold=0.6
             )
         )
-        
+
         # Contextual search with metadata filtering
         from models import ContextualSearchRequest
         contextual_results = await client.contextual_search(
@@ -144,7 +158,7 @@ async def main():
                 context_weight=0.4
             )
         )
-        
+
         # Multi-collection search
         from models import MultiCollectionSearchRequest
         multi_results = await client.multi_collection_search(
@@ -156,8 +170,43 @@ async def main():
                 cross_collection_reranking=True
             )
         )
-        
-        print(f"Found {len(results)} similar vectors")
+
+        # Hybrid search (dense + sparse vectors)
+        from models import HybridSearchRequest, SparseVector
+
+        sparse_query = SparseVector(
+            indices=[0, 5, 10, 15],
+            values=[0.8, 0.6, 0.9, 0.7]
+        )
+
+        hybrid_results = await client.hybrid_search(
+            HybridSearchRequest(
+                collection="my_collection",
+                query="search query",
+                query_sparse=sparse_query,
+                alpha=0.7,
+                algorithm="rrf",  # "rrf", "weighted", or "alpha"
+                dense_k=20,
+                sparse_k=20,
+                final_k=10
+            )
+        )
+
+        print(f"Found {len(hybrid_results.results)} similar vectors")
+
+        # Qdrant-compatible API usage
+        # List collections
+        qdrant_collections = await client.qdrant_list_collections()
+        print(f"Qdrant collections: {qdrant_collections}")
+
+        # Search points (Qdrant format)
+        qdrant_results = await client.qdrant_search_points(
+            collection="my_collection",
+            vector=embedding,
+            limit=10,
+            with_payload=True
+        )
+        print(f"Qdrant search results: {qdrant_results}")
 
 asyncio.run(main())
 ```
@@ -213,24 +262,26 @@ client = VectorizerClient(
 #### When to Use UMICP
 
 Use UMICP when:
+
 - **Large Payloads**: Inserting or searching large batches of vectors
 - **High Throughput**: Need maximum performance for production workloads
 - **Low Latency**: Need minimal protocol overhead
 
 Use HTTP when:
+
 - **Development**: Quick testing and debugging
 - **Firewall Restrictions**: Only HTTP/HTTPS allowed
 - **Simple Deployments**: No need for custom protocol setup
 
 #### Protocol Comparison
 
-| Feature | HTTP/HTTPS | UMICP |
-|---------|-----------|-------|
-| Transport | aiohttp (standard HTTP) | umicp-python package |
-| Performance | Standard | Optimized for large payloads |
-| Latency | Standard | Lower overhead |
-| Firewall | Widely supported | May require configuration |
-| Installation | Default | Requires umicp-python |
+| Feature      | HTTP/HTTPS              | UMICP                        |
+| ------------ | ----------------------- | ---------------------------- |
+| Transport    | aiohttp (standard HTTP) | umicp-python package         |
+| Performance  | Standard                | Optimized for large payloads |
+| Latency      | Standard                | Lower overhead               |
+| Firewall     | Widely supported        | May require configuration    |
+| Installation | Default                 | Requires umicp-python        |
 
 #### Installing with UMICP Support
 

{vectorizer_sdk-1.0.1 → vectorizer_sdk-1.3.0}/vectorizer_sdk.egg-info/top_level.txt

@@ -1,2 +1,3 @@
 dist
 utils
+venv

vectorizer_sdk-1.0.1/LICENSE

@@ -1,21 +0,0 @@
-# MIT License
-
-Copyright (c) 2025 CMMV-Hive Team
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.