Home

thalamic-relay

Lightweight CLI relay: hardware telemetry in → normalized stimuli / SNN step → UDP IPC + Prometheus.

Version: 0.1.0 | Edition: 2024 | License: MIT OR Apache-2.0

Software-only orchestration relay (no built-in FPGA / silicon-bridge dep). Observes GPU/CPU telemetry when available, steps an in-process neuromod SNN, exposes UDP control and Prometheus metrics. Degrades to simulated telemetry without NVIDIA/NVML.

Features

Area	Capability
GPU telemetry	NVML / nvidia-smi → GpuTelemetry
SNN	neuromod::SpikingNetwork + neuromodulators
UDP IPC	Stimuli, LearningReward, GetNeuroState
Metrics	Prometheus :9000/metrics
Safety	Thermal 85°C / power 350W + emergency brake
Process	Single-instance lockfile /tmp/thalamic_relay.lock

Start Here

Page	Description
Overview	Mission + DeepWiki map
Getting Started	Build, run, config
Architecture	Loop and modules
UDP IPC	Message types
CLI and Configuration	Flags / env
GPU Telemetry	HardwareBridge
Safety	Thresholds and brake
SNN Integration	neuromod wiring
Prometheus and Logging	Observability
Testing	Unit / IPC tests
CI and Quality	GHA
Ecosystem	Sibling crates
Glossary	Terms

Quick start

cargo build --release
cargo run --bin thalamic-relay
# software-only:
cargo run --bin thalamic-relay -- --force-software-only

UDP (default 127.0.0.1:9898):

{"type":"Stimuli","values":[0.1,0.2,0.0]}
{"type":"LearningReward","dopamine_delta":0.1,"cortisol_delta":0.0}
{"type":"GetNeuroState"}

Metrics: http://127.0.0.1:9000/metrics

License

Dual-licensed under MIT or Apache-2.0 at your option.

---

Last updated: July 29, 2026 Updated by: Grok Build: Grok 4.5 Package tip reference: e09cd4a (main) Devin DeepWiki: commit e09cd4a · thalamic-relay