bioIDE

Zero-backend JavaScript browser IDE for EEG.

Hardware stream uses the JavaScript SDK.

Packages

• packages/core — headless engine, file buffers, Comlink worker lifecycle
• packages/react — CodeMirror 6 wrappers and <SynapseIDE />
• apps/demo — Vite playground (editor left, terminal right)

Runtime

Student JS runs in a Web Worker. The sandbox injects:

• tf (@tensorflow/tfjs, CPU backend)
• EEG / Context.EEG — latest streamed frame
• bio — windowed history, recording, features, and small models
• console, check(condition, message)
• plot(title, values) / plot({ title, kind, labels, values|series })

Plots render above stdout in Output.

The host keeps a rolling frame history (mock or live) and seeds the worker on Run. EEG is one frame. bio.window(seconds) is the time window behind it.

bio

Call	Role
bio.window(seconds)	frames in the last N seconds
bio.signal(name|channel, seconds)	one series over that window
bio.features(frames)	mean bands + focus / relaxation
bio.record(label, ms)	wait, then append a labelled epoch
bio.dataset()	{ X, y, labels } for the session
bio.logreg(X, y)	L2 logistic regression
bio.crossValScore(X, y, k)	stratified k-fold, balanced accuracy
bio.cohensD(a, b)	within-session effect size

Also: isFocused, isRelaxed, bandPower, bands, mean, std, rms, zscore, fft, bandpower, kfold, trainTestSplit, accuracy, balancedAccuracy, confusion, sleep, clearDataset, epochs, help.

The session dataset lives in the worker until reload. History is frame-rate (about 12-30 Hz), not the full 250 Hz raw stream.

Recipes

The toolbar Recipes menu loads commented examples. API opens the sandbox list and the JavaScript SDK. Type EEG. or bio. in the editor for completions.

1. SDK helpers
2. Hello EEG
3. Band tensor
4. Tiny predict
5. Train a blink
6. Focus gate
7. Assert a model
8. Window features
9. Calibrate a classifier

Click Mock (or Connect), pick a recipe, then Run (Ctrl+Enter / ⌘↵). Window / calibrate recipes need the stream running first.

Optional hidden checks can be passed to IdeEngine (checks option or setChecks()). They are appended after the buffer on Run and never shown in the editor.

Setup

npm install
npm run dev

Then open the printed local URL and click Run. JavaScript executes in a Web Worker.