Step-by-step guides

PiEEG Tutorials

Practical walkthroughs for connecting hardware, building BCI experiments, and getting the most out of the PiEEG ecosystem. Contributed by the team and the community.

Beginner25 min

Run 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 Bluetooth
Read
Beginner15 min

Stream 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 Cloud
Read
Beginner15 min

Run 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 Rate
Read
Beginner20 min

BLE 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 Cloud
Read
Intermediate45 min

Build 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.

DiscordRAGPythonLLM
Read