strands-emotiv

An agent that can feel the person it's talking to.
EPOC X → Cortex → Strands tools · live brain dashboard · LeRobot v3 datasets.
docs · soul · dataset

_{▶ how it works}

2019: how do I control X with my mind? Blink = click. A slower keyboard. 2026: what does an agent become when it can feel you?

It notices when you tense up, go quiet, or light up, and changes how it talks.

Run

pip install strands-emotiv            # or: uv tool install strands-emotiv
export EMOTIV_CLIENT_ID=… EMOTIV_CLIENT_SECRET=…   # free Basic license
strands-emotiv doctor                 # Cortex ✓ headset ✓ streams ✓
strands-emotiv dashboard              # → localhost:8765

Use the USB dongle; the cable only charges. No headset: --fake replays 865 real samples.

What the agent sees

One line per turn. The dashboard shows the exact same line.

[brain: focus 0.71↑ · stress 0.22↓ · alpha dominant O1/O2 · still 38s · CQ 13/14 good]

Three speeds, never mixed: reflex ≤100 ms (blink · clench = veto) · ambient ~10 s (the line) · intent opt-in (one trained yes).

Dashboard

Left = you: skull with 14 live electrodes, 5 band topomaps, 10-min waterfall, head trail. Right = the agent: the line it reads, event river, metric radar, sonification, consent. Bottom: streaming chat. Under each message, the line it saw when you sent it.

The dataset

_{▶ 1 min: recording an episode on the dashboard}

Embodied chain-of-thought, brain edition: observation = band power · CQ · motion · metrics · facial · events @ 8 Hz. action = what the agent said. reward = your brain after the answer (Δstress, Δengagement across the turn boundary). LeRobot v3.0, trains with stock tooling.

from lerobot.datasets.lerobot_dataset import LeRobotDataset
ds = LeRobotDataset("cagataydev/emotiv-ecot")        # private
ds[80]["observation.state"].shape                    # [70]  14 ch × θ α βL βH γ
ds[80]["task"]
# TASK: One sentence: how does my brain look right now? | AMBIENT: [brain: theta dominant · CQ 13/14 good]
# | PLAN: Calm and settled… | TOOL: none | ACT: Calm and settled… | REWARD: Δstress=…

That's a real frame from the first live episode. ● REC in the header → talk → Publish.

Tools

from strands_emotiv.tools import brain_snapshot, brain_bands, head_pose, contact_quality, wait_for_brain_event
agent("wait until I blink twice, then tell me what my alpha did")

Every agent action stamps the EEG record (injectMarker). The loop closes both ways.

MCP

Any MCP client can feel the person wearing the headset. Claude Desktop, Cursor, Kiro, another agent:

{ "mcpServers": { "brain": { "command": "uvx", "args": ["strands-emotiv", "mcp"] } } }

13 tools: brain_line (the one line), brain_snapshot, brain_bands, head_pose, contact_quality, wait_for_brain_event, recent_brain_events, brain_status, mental_approval, and the four record_* tools. Add --http 8000 for streamable HTTP at /mcp, --fake to try it without a headset. Built on strands-mcp-server.

_{MIT · Cagatay Cali · 2019 → 2026}