Query → Vector Embedding → Initial Nodes → Graph Propagation → Activation Ranking → Results

Query: "What programming languages does Alice know?"

1. Vector search finds: [Alice:developer, Python:language, Alice:works_at_techcorp]
   Initial activation: Alice(1.0), Python(0.9), TechCorp(0.7)

2. Hop 1 (decay=0.85):
   Alice → knows → Python(0.85)
   Alice → knows → JavaScript(0.85)
   Alice → works_at → TechCorp(0.85)

3. Hop 2 (decay=0.72):
   TechCorp → uses → Python(0.72 × 0.9 = 0.65)
   TechCorp → uses → Rust(0.72)
   JavaScript → similar_to → TypeScript(0.61)

4. Results (above threshold=0.1):
   Python (0.90 + 0.65 = 1.55)
   JavaScript (0.85)
   TypeScript (0.61)
   Rust (0.72)

from hystersis import Hystersis

client = Hystersis(api_key="your-api-key")

# Standard vector search
results = client.search(query="Alice's programming skills")

# Enhanced search with spreading activation
results = client.search_enhanced(
    query="Alice's programming skills",
    mode="spreading",           # or "hybrid" for combined
    max_hops=3,                 # propagation depth
    threshold=0.1,              # minimum activation
    decay_factor=0.85           # per-hop decay
)

for result in results:
    print(f"{result.content} (activation: {result.activation_score:.2f})")

# Spreading activation search
curl -H "X-API-Key: your-key" \
  "https://api.hystersis.com/search/enhanced?mode=spreading&query=Alice+programming&max_hops=3&threshold=0.1"

# Spreading activation defaults
SPREADING_INITIAL_BUDGET=1.0
SPREADING_DECAY_FACTOR=0.85
SPREADING_THRESHOLD=0.1
SPREADING_MAX_HOPS=3
SPREADING_TOP_K=50