From d0968b56b69232e402c52c99446257e1c8b19583 Mon Sep 17 00:00:00 2001 From: Maxwell Calkin Date: Sun, 8 Mar 2026 13:24:53 -0400 Subject: [PATCH] Remove client-side default alpha for hybrid queries The hybrid query `alpha` parameter was hardcoded to 0.7 on the client side, preventing the server-side default from being used. This changes the default to None so the server determines the appropriate alpha value, consistent with how other parameters like `fusion_type` and `limit` already work. Fixes #1227 Co-Authored-By: Claude Opus 4.6 --- .../aggregations/hybrid/executor.py | 8 +++--- .../queries/hybrid/generate/executor.py | 28 +++++++++---------- .../queries/hybrid/query/executor.py | 28 +++++++++---------- 3 files changed, 32 insertions(+), 32 deletions(-) diff --git a/weaviate/collections/aggregations/hybrid/executor.py b/weaviate/collections/aggregations/hybrid/executor.py index fae005c9c..c2c87a68f 100644 --- a/weaviate/collections/aggregations/hybrid/executor.py +++ b/weaviate/collections/aggregations/hybrid/executor.py @@ -22,7 +22,7 @@ def hybrid( self, query: Optional[str], *, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[List[float]] = None, query_properties: Optional[List[str]] = None, object_limit: Optional[int] = None, @@ -40,7 +40,7 @@ def hybrid( self, query: Optional[str], *, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[List[float]] = None, query_properties: Optional[List[str]] = None, object_limit: Optional[int] = None, @@ -58,7 +58,7 @@ def hybrid( self, query: Optional[str], *, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[List[float]] = None, query_properties: Optional[List[str]] = None, object_limit: Optional[int] = None, @@ -75,7 +75,7 @@ def hybrid( self, query: Optional[str], *, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[List[float]] = None, query_properties: Optional[List[str]] = None, object_limit: Optional[int] = None, diff --git a/weaviate/collections/queries/hybrid/generate/executor.py b/weaviate/collections/queries/hybrid/generate/executor.py index 9b6762a2b..408e434b1 100644 --- a/weaviate/collections/queries/hybrid/generate/executor.py +++ b/weaviate/collections/queries/hybrid/generate/executor.py @@ -53,7 +53,7 @@ def hybrid( grouped_task: Union[str, _GroupedTask, None] = None, grouped_properties: Optional[List[str]] = None, generative_provider: Optional[_GenerativeConfigRuntime] = None, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[HybridVectorType] = None, query_properties: Optional[List[str]] = None, fusion_type: Optional[HybridFusion] = None, @@ -81,7 +81,7 @@ def hybrid( grouped_task: Union[str, _GroupedTask, None] = None, grouped_properties: Optional[List[str]] = None, generative_provider: Optional[_GenerativeConfigRuntime] = None, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[HybridVectorType] = None, query_properties: Optional[List[str]] = None, fusion_type: Optional[HybridFusion] = None, @@ -109,7 +109,7 @@ def hybrid( grouped_task: Union[str, _GroupedTask, None] = None, grouped_properties: Optional[List[str]] = None, generative_provider: Optional[_GenerativeConfigRuntime] = None, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[HybridVectorType] = None, query_properties: Optional[List[str]] = None, fusion_type: Optional[HybridFusion] = None, @@ -137,7 +137,7 @@ def hybrid( grouped_task: Union[str, _GroupedTask, None] = None, grouped_properties: Optional[List[str]] = None, generative_provider: Optional[_GenerativeConfigRuntime] = None, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[HybridVectorType] = None, query_properties: Optional[List[str]] = None, fusion_type: Optional[HybridFusion] = None, @@ -165,7 +165,7 @@ def hybrid( grouped_task: Union[str, _GroupedTask, None] = None, grouped_properties: Optional[List[str]] = None, generative_provider: Optional[_GenerativeConfigRuntime] = None, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[HybridVectorType] = None, query_properties: Optional[List[str]] = None, fusion_type: Optional[HybridFusion] = None, @@ -193,7 +193,7 @@ def hybrid( grouped_task: Union[str, _GroupedTask, None] = None, grouped_properties: Optional[List[str]] = None, generative_provider: Optional[_GenerativeConfigRuntime] = None, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[HybridVectorType] = None, query_properties: Optional[List[str]] = None, fusion_type: Optional[HybridFusion] = None, @@ -223,7 +223,7 @@ def hybrid( grouped_task: Union[str, _GroupedTask, None] = None, grouped_properties: Optional[List[str]] = None, generative_provider: Optional[_GenerativeConfigRuntime] = None, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[HybridVectorType] = None, query_properties: Optional[List[str]] = None, fusion_type: Optional[HybridFusion] = None, @@ -251,7 +251,7 @@ def hybrid( grouped_task: Union[str, _GroupedTask, None] = None, grouped_properties: Optional[List[str]] = None, generative_provider: Optional[_GenerativeConfigRuntime] = None, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[HybridVectorType] = None, query_properties: Optional[List[str]] = None, fusion_type: Optional[HybridFusion] = None, @@ -279,7 +279,7 @@ def hybrid( grouped_task: Union[str, _GroupedTask, None] = None, grouped_properties: Optional[List[str]] = None, generative_provider: Optional[_GenerativeConfigRuntime] = None, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[HybridVectorType] = None, query_properties: Optional[List[str]] = None, fusion_type: Optional[HybridFusion] = None, @@ -307,7 +307,7 @@ def hybrid( grouped_task: Union[str, _GroupedTask, None] = None, grouped_properties: Optional[List[str]] = None, generative_provider: Optional[_GenerativeConfigRuntime] = None, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[HybridVectorType] = None, query_properties: Optional[List[str]] = None, fusion_type: Optional[HybridFusion] = None, @@ -335,7 +335,7 @@ def hybrid( grouped_task: Union[str, _GroupedTask, None] = None, grouped_properties: Optional[List[str]] = None, generative_provider: Optional[_GenerativeConfigRuntime] = None, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[HybridVectorType] = None, query_properties: Optional[List[str]] = None, fusion_type: Optional[HybridFusion] = None, @@ -363,7 +363,7 @@ def hybrid( grouped_task: Union[str, _GroupedTask, None] = None, grouped_properties: Optional[List[str]] = None, generative_provider: Optional[_GenerativeConfigRuntime] = None, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[HybridVectorType] = None, query_properties: Optional[List[str]] = None, fusion_type: Optional[HybridFusion] = None, @@ -392,7 +392,7 @@ def hybrid( grouped_task: Union[str, _GroupedTask, None] = None, grouped_properties: Optional[List[str]] = None, generative_provider: Optional[_GenerativeConfigRuntime] = None, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[HybridVectorType] = None, query_properties: Optional[List[str]] = None, fusion_type: Optional[HybridFusion] = None, @@ -421,7 +421,7 @@ def hybrid( grouped_task: Union[str, _GroupedTask, None] = None, grouped_properties: Optional[List[str]] = None, generative_provider: Optional[_GenerativeConfigRuntime] = None, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[HybridVectorType] = None, query_properties: Optional[List[str]] = None, fusion_type: Optional[HybridFusion] = None, diff --git a/weaviate/collections/queries/hybrid/query/executor.py b/weaviate/collections/queries/hybrid/query/executor.py index 7ed027abb..4c618f961 100644 --- a/weaviate/collections/queries/hybrid/query/executor.py +++ b/weaviate/collections/queries/hybrid/query/executor.py @@ -45,7 +45,7 @@ def hybrid( self, query: Optional[str], *, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[HybridVectorType] = None, query_properties: Optional[List[str]] = None, fusion_type: Optional[HybridFusion] = None, @@ -69,7 +69,7 @@ def hybrid( self, query: Optional[str], *, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[HybridVectorType] = None, query_properties: Optional[List[str]] = None, fusion_type: Optional[HybridFusion] = None, @@ -93,7 +93,7 @@ def hybrid( self, query: Optional[str], *, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[HybridVectorType] = None, query_properties: Optional[List[str]] = None, fusion_type: Optional[HybridFusion] = None, @@ -117,7 +117,7 @@ def hybrid( self, query: Optional[str], *, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[HybridVectorType] = None, query_properties: Optional[List[str]] = None, fusion_type: Optional[HybridFusion] = None, @@ -141,7 +141,7 @@ def hybrid( self, query: Optional[str], *, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[HybridVectorType] = None, query_properties: Optional[List[str]] = None, fusion_type: Optional[HybridFusion] = None, @@ -165,7 +165,7 @@ def hybrid( self, query: Optional[str], *, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[HybridVectorType] = None, query_properties: Optional[List[str]] = None, fusion_type: Optional[HybridFusion] = None, @@ -191,7 +191,7 @@ def hybrid( self, query: Optional[str], *, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[HybridVectorType] = None, query_properties: Optional[List[str]] = None, fusion_type: Optional[HybridFusion] = None, @@ -215,7 +215,7 @@ def hybrid( self, query: Optional[str], *, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[HybridVectorType] = None, query_properties: Optional[List[str]] = None, fusion_type: Optional[HybridFusion] = None, @@ -239,7 +239,7 @@ def hybrid( self, query: Optional[str], *, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[HybridVectorType] = None, query_properties: Optional[List[str]] = None, fusion_type: Optional[HybridFusion] = None, @@ -263,7 +263,7 @@ def hybrid( self, query: Optional[str], *, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[HybridVectorType] = None, query_properties: Optional[List[str]] = None, fusion_type: Optional[HybridFusion] = None, @@ -287,7 +287,7 @@ def hybrid( self, query: Optional[str], *, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[HybridVectorType] = None, query_properties: Optional[List[str]] = None, fusion_type: Optional[HybridFusion] = None, @@ -311,7 +311,7 @@ def hybrid( self, query: Optional[str], *, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[HybridVectorType] = None, query_properties: Optional[List[str]] = None, fusion_type: Optional[HybridFusion] = None, @@ -336,7 +336,7 @@ def hybrid( self, query: Optional[str], *, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[HybridVectorType] = None, query_properties: Optional[List[str]] = None, fusion_type: Optional[HybridFusion] = None, @@ -361,7 +361,7 @@ def hybrid( self, query: Optional[str], *, - alpha: NUMBER = 0.7, + alpha: Optional[NUMBER] = None, vector: Optional[HybridVectorType] = None, query_properties: Optional[List[str]] = None, fusion_type: Optional[HybridFusion] = None,