A curriculum for living signals
Learn by followingthe signal.
Start with the connection you can touch. Keep the acquisition visible. Then follow every frame into software, analysis, XR, automation, or an experiment of your own.
01 / Learning principle
Understanding begins where abstraction ends.
PiEEG is an open instrument, so the learning path should be open too. Every guide begins with a real input, names the transport, exposes the transformation, and ends with something you can test.
02 / Choose your entry point
One signal.
Three ways in.
Enter at the part of the system you are holding now. The route stays continuous, so you can move backward to the electrodes or forward into an application at any time.
Bring the instrument online.
Identify the device, required equipment, power conditions, and electrode connections before asking software to interpret anything.
Choose your hardware guideelectrodes → acquisition board → host03 / Field guides
Build something that answers back.
Practical walkthroughs from the PiEEG team and community, organized around complete signal routes rather than disconnected features.
Control Your VRChat Avatar with Live Brain Signals
Design brain-reactive avatar expressions with Avatar Foundation V2, then stream them live into VRChat. Train custom EEG mappings, see which brain signals drive which expressions, and wire the same parameters into your VRChat avatar via OSC. Two streaming paths: Cloud + Neural Stream + Local Bridge, or pieeg-server direct.
VRChatOSCEEGAvatar FoundationRun PiEEG XR Inside Meta Quest: Every Path, Fastest First
You have the PiEEG XR on your headset — now use it. The zero-install path first: open PiEEG Cloud on your PC and mirror it into the Quest with the screen-streaming you already know. Plus three more routes — PiEEG Server, OSC into VRChat, and the BodyPress app — and the three experiences to try first.
QuestPiEEG XRBLEWeb BluetoothStream Your Brain into TouchDesigner: Neural Stream over OSC
PiEEG Cloud's new Neural Stream turns your live headset into a tree of named OSC channels. Point a single TouchDesigner OSC In CHOP at your machine and the whole brain — focus, relax, band powers, per-channel activity, blink pulses — arrives as CHOP channels with zero per-address wiring. This guide walks you from a fresh dashboard to reactive visuals.
TouchDesignerOSCCHOPPiEEG CloudRun BodyPress on Meta Quest: Sideload the Biosignal Journal App
BodyPress turns your physiological signals into a daily first-person journal — and because it speaks Bluetooth Low Energy, it pairs directly with PiEEG and other community BCI hardware. This guide explains what BodyPress is and walks you through sideloading the APK onto a Meta Quest headset, so you can stream heart-rate and multi-channel biosignals and read the story your body writes.
QuestBodyPressBLEHeart RateBLE End-to-End on Meta Quest: Chromium + PiEEG Cloud to PiEEG XR
Run a complete BLE pipeline entirely on your Meta Quest headset — flash Octopus-16 firmware once on a PC, then use the Quest's Chromium browser to connect over Web Bluetooth, stream 16-channel EEG through PiEEG Cloud, and launch PiEEG XR, all without touching a desktop again.
QuestBLEWeb BluetoothPiEEG CloudBuild a Documentation RAG Discord Bot for Your Community
Build PiEEG-bot from scratch — a Discord companion that answers hardware and software questions from your own docs using a lightweight retrieval-augmented pipeline. Clone the docs, chunk by heading, embed locally with fastembed (no API key), search with NumPy cosine similarity, and ground every answer in Claude Haiku with links back to the source pages.
DiscordRAGPythonLLM04 / Reference library
When the experiment gets specific.
The documentation follows the same visible system: instrument, software, and the routes leading outward.
DOC / HWHardware setup
Devices, required equipment, connections, electrodes, caps, power, and signal quality.
Enter referenceDOC / SWServer and software
Installation, configuration, dashboard, recording, detectors, and real-time streaming.
Enter referenceDOC / APIWebSocket and API
The connection contract, JSON frames, client commands, recording, webhooks, OSC, and LSL control.
Enter referenceBefore the first recording
A clean signal starts with a safe setup.
PiEEG hardware is for research, engineering, learning, and development—not medical diagnosis or treatment. Read the official power, electrode, and liability guidance before connecting a person to a device.
Read safety guidance06 / Continue the signal