Skip to content

Graph-Native Infrastructure for Context and Accountable AI Systems

fix(context): treat Node2Vec as optional when gensim is missing (#1728)

Chaoqi5bf81ae45018
diff --git a/semantica/context/context_graph.py b/semantica/context/context_graph.py
index 00528f49..96445253 100644
--- a/semantica/context/context_graph.py
+++ b/semantica/context/context_graph.py
@@ -654,7 +654,10 @@ class ContextGraph:
if self.config.get("community_detection", True):
self.kg_components["community_detector"] = CommunityDetector()
if self.config.get("node_embeddings", True):
- self.kg_components["node_embedder"] = NodeEmbedder()
+ try:
+ self.kg_components["node_embedder"] = NodeEmbedder()
+ except ImportError as e:
+ self.logger.warning(f"Node2Vec embeddings disabled: {e}")
self.kg_components["path_finder"] = PathFinder()
self.kg_components["similarity_calculator"] = SimilarityCalculator()
self.kg_components["connectivity_analyzer"] = ConnectivityAnalyzer()
diff --git a/semantica/context/decision_query.py b/semantica/context/decision_query.py
index 4fb0dc39..612d035e 100644
--- a/semantica/context/decision_query.py
+++ b/semantica/context/decision_query.py
@@ -148,7 +148,10 @@ class DecisionQuery:
if community_detection:
self.kg_components["community_detector"] = CommunityDetector()
if node_embeddings:
- self.kg_components["node_embedder"] = NodeEmbedder()
+ try:
+ self.kg_components["node_embedder"] = NodeEmbedder()
+ except ImportError as e:
+ self.logger.warning(f"Node2Vec embeddings disabled: {e}")
self.kg_components["path_finder"] = PathFinder()
self.kg_components["similarity_calculator"] = SimilarityCalculator()
if link_prediction:
diff --git a/semantica/vector_store/decision_embedding_pipeline.py b/semantica/vector_store/decision_embedding_pipeline.py
index 882f7b40..f8b32014 100644
--- a/semantica/vector_store/decision_embedding_pipeline.py
+++ b/semantica/vector_store/decision_embedding_pipeline.py
@@ -138,14 +138,19 @@ class DecisionEmbeddingPipeline:
# Initialize node embedder if graph store provided
if graph_store:
- self.node_embedder = node_embedder or NodeEmbedder(
- method="node2vec",
- embedding_dimension=node_embedding_dimension,
- walk_length=80,
- num_walks=10,
- p=1.0,
- q=1.0
- )
+ if node_embedder is None:
+ try:
+ node_embedder = NodeEmbedder(
+ method="node2vec",
+ embedding_dimension=node_embedding_dimension,
+ walk_length=80,
+ num_walks=10,
+ p=1.0,
+ q=1.0
+ )
+ except ImportError as e:
+ self.logger.warning(f"Structural embeddings disabled: {e}")
+ self.node_embedder = node_embedder
# Initialize advanced KG algorithms if enabled
if self.use_graph_features:
@@ -198,7 +203,9 @@ class DecisionEmbeddingPipeline:
)
# Enrich metadata
- enriched_metadata = self._enrich_metadata(decision_data)
+ enriched_metadata = self._enrich_metadata(
+ decision_data, structural_embedding is not None
+ )
# Store embeddings if requested
vector_id = None
@@ -709,7 +716,9 @@ class DecisionEmbeddingPipeline:
return combined
- def _enrich_metadata(self, decision_data: Dict[str, Any]) -> Dict[str, Any]:
+ def _enrich_metadata(
+ self, decision_data: Dict[str, Any], has_structural_embedding: bool
+ ) -> Dict[str, Any]:
"""Enrich decision metadata with additional information."""
metadata = decision_data.copy()
@@ -719,7 +728,7 @@ class DecisionEmbeddingPipeline:
"embedding_generated_at": datetime.now(timezone.utc).isoformat(),
"semantic_weight": self.semantic_weight,
"structural_weight": self.structural_weight,
- "has_structural_embedding": self.graph_store is not None
+ "has_structural_embedding": has_structural_embedding
})
return metadata
diff --git a/tests/test_issue_1513_slim_core.py b/tests/test_issue_1513_slim_core.py
index 5d186907..2c4d3edd 100644
--- a/tests/test_issue_1513_slim_core.py
+++ b/tests/test_issue_1513_slim_core.py
@@ -251,6 +251,51 @@ def test_node_embedder_gensim_missing_hint():
NodeEmbedder()
+def test_agent_context_with_graph_builds_without_gensim():
+ with patch("semantica.kg.node_embeddings.GENSIM_AVAILABLE", False):
+ from semantica.context import AgentContext, ContextGraph
+ from semantica.vector_store import VectorStore
+
+ ctx = AgentContext(
+ vector_store=VectorStore(backend="inmemory", dimension=64),
+ knowledge_graph=ContextGraph(),
+ decision_tracking=True,
+ )
+ decision_id = ctx.record_decision(
+ category="loan",
+ scenario="small business loan",
+ reasoning="strong cash flow",
+ outcome="approved",
+ confidence=0.9,
+ )
+
+ assert decision_id
+ assert ctx.retriever.decision_pipeline.node_embedder is None
+
+ processed = ctx.retriever.decision_pipeline.process_decision(
+ {"scenario": "small business loan"}, store_embeddings=False
+ )
+ assert processed["structural_embedding"] is None
+ assert processed["metadata"]["has_structural_embedding"] is False
+
+
+def test_graph_components_without_gensim_keep_everything_but_node2vec():
+ with patch("semantica.kg.node_embeddings.GENSIM_AVAILABLE", False):
+ from semantica.context import ContextGraph, DecisionQuery
+
+ graph_components = ContextGraph(advanced_analytics=True).kg_components
+ query_components = DecisionQuery(graph_store=ContextGraph()).kg_components
+
+ for components in (graph_components, query_components):
+ assert "node_embedder" not in components
+ assert {
+ "centrality_calculator",
+ "community_detector",
+ "path_finder",
+ "similarity_calculator",
+ } <= set(components)
+
+
def test_faiss_store_missing_hint():
with patch("semantica.vector_store.faiss_store.FAISS_AVAILABLE", False):
from semantica.vector_store.faiss_store import FAISSIndexBuilder, FAISSStore
diff --git a/tests/vector_store/test_decision_embedding_pipeline.py b/tests/vector_store/test_decision_embedding_pipeline.py
index 9293f726..4b93d594 100644
--- a/tests/vector_store/test_decision_embedding_pipeline.py
+++ b/tests/vector_store/test_decision_embedding_pipeline.py
@@ -226,7 +226,7 @@ class TestDecisionEmbeddingPipeline:
def test_enrich_metadata(self):
"""Test metadata enrichment."""
- enriched = self.pipeline._enrich_metadata(self.sample_decision)
+ enriched = self.pipeline._enrich_metadata(self.sample_decision, False)
assert "pipeline_version" in enriched
assert "embedding_generated_at" in enriched
@@ -236,7 +236,7 @@ class TestDecisionEmbeddingPipeline:
assert enriched["semantic_weight"] == 0.7
assert enriched["structural_weight"] == 0.3
- assert enriched["has_structural_embedding"] == True
+ assert enriched["has_structural_embedding"] is False
def test_find_similar_decisions(self):
"""Test finding similar decisions."""