Skip to content

thesnmc/SnapBack

Repository files navigation

SnapBack v4

Physiological autonomy protocol — publish Autonomy Envelope v1 over ZeroMQ and WebSocket.

Spec: spec/SPEC.md | Integration: spec/INTEGRATION.md | Stack: docs/STACK.md

Quick start (no EEG)

pip install -e ".[producer,dev]"
snapback-up

WebSocket: ws://127.0.0.1:8765 | ZeroMQ: tcp://127.0.0.1:5555

Commands

Command Role
snapback-up Daemon + optional --dashboard
snapback-daemon Background producer + WS
snapback-producer Interactive EEG producer
snapback-conform Validate envelopes (--producer)
snapback-flanker ERN validation task
snapback-validate-report Report from vault
snapback-mcp MCP stdio tools for agents

Profiles

  • snapback/profile/keyboard-proxy-v1 — no headset (default for snapback-up)
  • snapback/profile/synthetic-dev — simulated EEG
  • snapback/profile/ern-flanker-v1 — flanker ERN study

SNAPBACK_PROFILE_ID=snapback/profile/synthetic-dev snapback-daemon

Hardware path (AXON-6)

Pair with AXON-6 for encrypted UDP to serial/ROS2:

snapback-up
axon6 receiver --robot
axon6 bridge snapback

See docs/STACK.md.

SDK

Python: from snapback.client import SnapBackClient

TypeScript: packages/snapback-js (@snapback/client)

VS Code: extensions/snapback-guard

License

Apache 2.0

About

An offline BCI routing engine that throttles AI autonomy, robotics, and OS hardware based on real-time cognitive state, using ERN spikes to instantly freeze LLMs.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors