PIEEG / AGENTNATURAL-LANGUAGE EEG LABINTERFACE / 01

A conversation with the signal

Ask the signala question.

PiEEG Agent is a natural-language EEG lab notebook. It connects questions to documented analysis tools while keeping the measurement method visible.

Inspect the source Follow the reasoning
PIEEG AGENT / TOOL TRACE READ-ONLY
QUESTION / NATURAL LANGUAGE

“How is my signal?”

01 / REQUESTQuestion parsedNo voltage arrays sent as prose
02 / TOOL CALLget_channel_qualityLive LSL window
03 / RESPONSEExplain the measureInspect every channel before reporting state.
METHOD / DOCUMENTED BEHAVIORgood / flat / rail / noisy / lineQuality gate before interpretation
SourcePiEEG or any LSL device
MemoryRing buffer
InterfaceNamed analysis tools
ResponseMeasured + explained

01 / Tool grammar

Language opens the tool.
It does not replace it.

A question selects a documented operation. The operation reads the signal, returns a measured result, and preserves its scientific limits.

01

Monitor the state

get_neural_state / get_channel_quality

Read session-relative focus, relaxation, engagement, band powers, signal quality, and recent state changes on demand.

02

Teach a pattern

start / record / finish_pattern_training

Capture labeled rest and active repetitions, fit a regularized detector, and report leave-one-repetition-out validation.

03

Inspect the spectrum

analyze_spectrum / connectivity

Request individual alpha frequency, aperiodic slope, spectral entropy, frontal asymmetry, or cross-channel amplitude coupling.

04

Compare the sessions

record_session / compare_sessions

Capture labeled windows and describe their within-session differences with effect sizes and explicit limits on generalization.

02 / Architecture

The model never becomes
the measurement.

The acquisition path continues even when no language model is running.

01

Ingest

A dedicated LSL thread and ring buffer keep incoming samples separate from language-model latency.

02

Request

The model pulls named tools on demand. Raw voltage arrays are not continuously pushed into the conversation.

03

Represent

Events and measured features create language-sized representations while the original stream remains available.

04

Gate

Device actions stay read-only by default, with preview and execute modes made explicit.

03 / Local instrument

From source to local lab.

PiEEG Agent requires Python 3.10 or later. Its prebuilt frontend does not require a local Node.js installation.

Open installation guide
01 / INSTALL · LINUX / MACOS / WSL
curl -sSL https://raw.githubusercontent.com/pieeg-club/PiEEG-agent/main/install.sh | bash
02 / LAUNCH WEB INTERFACE
pieeg-agent webOpen http://localhost:8000 after launch.
03 / TEST WITHOUT HARDWARE
pieeg-server --mock --lslpieeg-agent web

04 / Action boundary

Read first.
Act deliberately.

Device control is optional. The default web command is read-only; preview and execution require explicit command-line modes.

01READ-ONLYpieeg-agent web

Monitoring and analysis. No device-control actions.

02PREVIEWpieeg-agent web --allow-actions

Shows the proposed action without executing it.

03EXECUTEpieeg-agent web --allow-actions --execute

Runs allowed actions through cooldowns, allowlists, and audit logging.

PiEEG Agent is designed for neurofeedback research and UX prototyping—not clinical use. Focus, relaxation, and engagement are session-relative indices rather than clinical values.

Question / Tool / Measure / Explain

Conversation is the interface.
The signal remains the evidence.

Build with PiEEG Agent Inspect PiEEG Server Read documentation