# dreamsproxy/lisnn architecture

> Architecture diagram of the GitHub repository dreamsproxy/lisnn, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dreamsproxy/lisnn
- Repository: https://github.com/dreamsproxy/lisnn

## Overview

LiSNN’s active product is an experimental, vectorized spiking-neuron substrate; the legacy tree is explicitly frozen. The user-facing path is constructing a homogeneous or mixed population, then—where desired—stepping it with fixed-weight causal propagation. Population layout, model dispatch, sparse topology, and validation form the supporting layers. Spatial utilities and smoke diagnostics are separate capabilities. Runtime source was only partly sampled, so edges are limited to README statements and references visible in the SOURCE INDEX; the graph does not imply task-driven learning, which the README says is not implemented.

Main entry points: [`lisnn/network/runtime.py`](https://github.com/dreamsproxy/lisnn/blob/main/lisnn/network/runtime.py) (Fixed-weight runtime), [`lisnn/network/core.py`](https://github.com/dreamsproxy/lisnn/blob/main/lisnn/network/core.py) (SNN constructor), [`lisnn/synapses/propagation.py`](https://github.com/dreamsproxy/lisnn/blob/main/lisnn/synapses/propagation.py) (Current propagation), [`lisnn/neurons/registry.py`](https://github.com/dreamsproxy/lisnn/blob/main/lisnn/neurons/registry.py) (Neuron registry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_construction["Network construction"]
  node_demo["Construction example<br/>[main.py]"]
  node_network["SNN constructor<br/>[core.py]"]
  node_spec["Population specification<br/>[spec.py]"]
  node_population["Population builder<br/>[population.py]"]
end

subgraph group_neurons["Neuron substrate"]
  node_layout["Population layout<br/>[layout.py]"]
  node_registry["Neuron registry<br/>[registry.py]"]
  node_kernels["Vectorized kernels<br/>[kernels.py]"]
  node_adapters["Izhikevich adapters<br/>[adapters.py]"]
end

subgraph group_connectivity["Connectivity and runtime"]
  node_synapses["Sparse topology<br/>[core.py]"]
  node_propagation["Current propagation<br/>[propagation.py]"]
  node_runtime["Fixed-weight runtime<br/>[runtime.py]"]
  node_validation["Numeric validation<br/>[validation.py]"]
end

subgraph group_support["Spatial and diagnostics"]
  node_morphology["Spatial morphology<br/>[morphology.py]"]
  node_placement["Spatial placement<br/>[placement.py]"]
  node_volume["Spatial volume<br/>[volume.py]"]
  node_smoke["Smoke-suite runner<br/>[runner.py]"]
  node_neuroncheck["Population diagnostics<br/>[neuron_smoke.py]"]
  node_synapsecheck["Synapse diagnostics<br/>[synapse_smoke.py]"]
end

node_user(("Engineer"))

node_user -->|"constructs"| node_network
node_demo -->|"demonstrates"| node_network
node_network -->|"uses"| node_spec
node_network -->|"resolves models"| node_registry
node_network -.->|"builds"| node_population
node_network -.->|"uses"| node_layout
node_registry -->|"registers steps"| node_kernels
node_runtime -->|"steps"| node_network
node_runtime -->|"resolves steps"| node_registry
node_runtime -->|"runs kernels"| node_kernels
node_runtime -->|"adapts units"| node_adapters
node_runtime -->|"reads edges"| node_synapses
node_runtime -->|"propagates spikes"| node_propagation
node_runtime -->|"validates inputs"| node_validation
node_propagation -->|"validates edges"| node_synapses
node_propagation -->|"validates values"| node_validation
node_volume -->|"uses placement"| node_placement
node_smoke -->|"runs"| node_neuroncheck
node_smoke -->|"runs"| node_synapsecheck

click node_demo "https://github.com/dreamsproxy/lisnn/blob/main/main.py"
click node_network "https://github.com/dreamsproxy/lisnn/blob/main/lisnn/network/core.py"
click node_spec "https://github.com/dreamsproxy/lisnn/blob/main/lisnn/network/spec.py"
click node_population "https://github.com/dreamsproxy/lisnn/blob/main/lisnn/neurons/population.py"
click node_layout "https://github.com/dreamsproxy/lisnn/blob/main/lisnn/neurons/layout.py"
click node_registry "https://github.com/dreamsproxy/lisnn/blob/main/lisnn/neurons/registry.py"
click node_kernels "https://github.com/dreamsproxy/lisnn/blob/main/lisnn/neurons/kernels.py"
click node_adapters "https://github.com/dreamsproxy/lisnn/blob/main/lisnn/neurons/adapters.py"
click node_synapses "https://github.com/dreamsproxy/lisnn/blob/main/lisnn/synapses/core.py"
click node_propagation "https://github.com/dreamsproxy/lisnn/blob/main/lisnn/synapses/propagation.py"
click node_runtime "https://github.com/dreamsproxy/lisnn/blob/main/lisnn/network/runtime.py"
click node_validation "https://github.com/dreamsproxy/lisnn/blob/main/lisnn/validation.py"
click node_morphology "https://github.com/dreamsproxy/lisnn/blob/main/lisnn/spatial/morphology.py"
click node_placement "https://github.com/dreamsproxy/lisnn/blob/main/lisnn/spatial/placement.py"
click node_volume "https://github.com/dreamsproxy/lisnn/blob/main/lisnn/spatial/volume.py"
click node_smoke "https://github.com/dreamsproxy/lisnn/blob/main/lisnn/debugging/runner.py"
click node_neuroncheck "https://github.com/dreamsproxy/lisnn/blob/main/lisnn/debugging/neuron_smoke.py"
click node_synapsecheck "https://github.com/dreamsproxy/lisnn/blob/main/lisnn/debugging/synapse_smoke.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_demo,node_network,node_spec,node_population toneBlue
class node_layout,node_registry,node_kernels,node_adapters toneAmber
class node_synapses,node_propagation,node_runtime,node_validation toneMint
class node_morphology,node_placement,node_volume,node_smoke,node_neuroncheck,node_synapsecheck toneRose
class node_user toneIndigo
```

## Components

### Network construction

- [Construction example](https://github.com/dreamsproxy/lisnn/blob/main/main.py): `main.py`
- [SNN constructor](https://github.com/dreamsproxy/lisnn/blob/main/lisnn/network/core.py): `lisnn/network/core.py`
- [Population specification](https://github.com/dreamsproxy/lisnn/blob/main/lisnn/network/spec.py): `lisnn/network/spec.py`
- [Population builder](https://github.com/dreamsproxy/lisnn/blob/main/lisnn/neurons/population.py): `lisnn/neurons/population.py`

### Neuron substrate

- [Population layout](https://github.com/dreamsproxy/lisnn/blob/main/lisnn/neurons/layout.py): `lisnn/neurons/layout.py`
- [Neuron registry](https://github.com/dreamsproxy/lisnn/blob/main/lisnn/neurons/registry.py): `lisnn/neurons/registry.py`
- [Vectorized kernels](https://github.com/dreamsproxy/lisnn/blob/main/lisnn/neurons/kernels.py): `lisnn/neurons/kernels.py`
- [Izhikevich adapters](https://github.com/dreamsproxy/lisnn/blob/main/lisnn/neurons/adapters.py): `lisnn/neurons/adapters.py`

### Connectivity and runtime

- [Sparse topology](https://github.com/dreamsproxy/lisnn/blob/main/lisnn/synapses/core.py): `lisnn/synapses/core.py`
- [Current propagation](https://github.com/dreamsproxy/lisnn/blob/main/lisnn/synapses/propagation.py): `lisnn/synapses/propagation.py`
- [Fixed-weight runtime](https://github.com/dreamsproxy/lisnn/blob/main/lisnn/network/runtime.py): `lisnn/network/runtime.py`
- [Numeric validation](https://github.com/dreamsproxy/lisnn/blob/main/lisnn/validation.py): `lisnn/validation.py`

### Spatial and diagnostics

- [Spatial morphology](https://github.com/dreamsproxy/lisnn/blob/main/lisnn/spatial/morphology.py): `lisnn/spatial/morphology.py`
- [Spatial placement](https://github.com/dreamsproxy/lisnn/blob/main/lisnn/spatial/placement.py): `lisnn/spatial/placement.py`
- [Spatial volume](https://github.com/dreamsproxy/lisnn/blob/main/lisnn/spatial/volume.py): `lisnn/spatial/volume.py`
- [Smoke-suite runner](https://github.com/dreamsproxy/lisnn/blob/main/lisnn/debugging/runner.py): `lisnn/debugging/runner.py`
- [Population diagnostics](https://github.com/dreamsproxy/lisnn/blob/main/lisnn/debugging/neuron_smoke.py): `lisnn/debugging/neuron_smoke.py`
- [Synapse diagnostics](https://github.com/dreamsproxy/lisnn/blob/main/lisnn/debugging/synapse_smoke.py): `lisnn/debugging/synapse_smoke.py`

### Other components

- **Engineer**

## Connections

- Engineer → SNN constructor: constructs
- Construction example → SNN constructor: demonstrates (evidence: `main.py`)
- SNN constructor → Population specification: uses (evidence: `lisnn/network/core.py`)
- SNN constructor → Neuron registry: resolves models (evidence: `lisnn/network/core.py`)
- SNN constructor → Population builder: builds
- SNN constructor → Population layout: uses
- Neuron registry → Vectorized kernels: registers steps (evidence: `lisnn/neurons/registry.py`)
- Fixed-weight runtime → SNN constructor: steps (evidence: `lisnn/network/runtime.py`)
- Fixed-weight runtime → Neuron registry: resolves steps (evidence: `lisnn/network/runtime.py`)
- Fixed-weight runtime → Vectorized kernels: runs kernels (evidence: `lisnn/network/runtime.py`)
- Fixed-weight runtime → Izhikevich adapters: adapts units (evidence: `lisnn/network/runtime.py`)
- Fixed-weight runtime → Sparse topology: reads edges (evidence: `lisnn/network/runtime.py`)
- Fixed-weight runtime → Current propagation: propagates spikes (evidence: `lisnn/network/runtime.py`)
- Fixed-weight runtime → Numeric validation: validates inputs (evidence: `lisnn/network/runtime.py`)
- Current propagation → Sparse topology: validates edges (evidence: `lisnn/synapses/propagation.py`)
- Current propagation → Numeric validation: validates values (evidence: `lisnn/synapses/propagation.py`)
- Spatial volume → Spatial placement: uses placement (evidence: `lisnn/spatial/volume.py`)
- Smoke-suite runner → Population diagnostics: runs (evidence: `lisnn/debugging/runner.py`)
- Smoke-suite runner → Synapse diagnostics: runs (evidence: `lisnn/debugging/runner.py`)
