lex-hebbian-assembly

Hebbian cell assembly learning for LegionIO agents. Part of the LegionIO cognitive architecture extension ecosystem (LEX).

lex-hebbian-assembly implements the classic Hebbian learning rule: units that are co-activated together have their mutual synaptic weights strengthened. Over repeated co-activations, tightly connected unit clusters are detected and promoted into named assemblies. Pattern completion allows a partial cue set to retrieve the full set of associated units.

Key capabilities:

• Hebbian weight updates: co-activate any set of unit IDs to strengthen their pairwise connections
• Assembly detection: clusters of mutually connected units (average weight >= 0.3, min 3 units) promoted to named assemblies
• Pattern completion: provide a partial cue set; retrieves all units reachable above the activation threshold
• Weight decay: periodic decay of all synaptic weights; dissolved assemblies are removed
• State lifecycle: assemblies progress through forming -> active -> primed -> dormant -> dissolving

Add to your Gemfile:

gem 'lex-hebbian-assembly'

Or install directly:

gem install lex-hebbian-assembly

require 'legion/extensions/hebbian_assembly'

client = Legion::Extensions::HebbianAssembly::Client.new

# Co-activate units that fired together
client.co_activate_units(unit_ids: [:concept_a, :concept_b, :concept_c])

# After repeated co-activations, assemblies are detected
client.list_assemblies
# => [{ id: "...", unit_ids: [:concept_a, :concept_b, :concept_c], state: :active }]

# Complete a partial pattern
client.pattern_complete(partial_ids: [:concept_a])
# => { completed_units: [:concept_a, :concept_b, :concept_c], ... }

# Inspect weights
client.query_weight(unit_id: :concept_a, other_id: :concept_b)
# => { weight: 0.45, label: :strong }

# Maintenance (also runs automatically every 60 seconds via actor)
client.update_hebbian

# Stats
client.hebbian_stats

bundle install
bundle exec rspec
bundle exec rubocop

MIT