PROJECT MAP
Ten parts.
One open project.
Choose a component and check its current evidence.
FIVE REPOSITORIES / ONE PROJECT
The whole
toolkit.
SDKs, connections and tools.
Pick a part to explore.
01GatewayMCP + transports
Run the gateway on your computer. Stdio MCP and local serve on loopback. Gadgets stay on 127.0.0.1, or one private address for Wi-Fi devices. With --oauth behind a tunnel you run, Grok Bot calls the six tools natively from the Mac and phone apps.
Local MCP verified · Grok Bot native calls verified on the owner's setup
02SimulatorNo hardware needed
Try the virtual light here, customize it, then export the configuration for the local simulator kit.
Simulated · explicit opt-in · part of the gateway
cd ../grok-gadgets-gateway
uv sync --locked
uv run python -m grok_gadgets_gateway.demo03USB bridgeSerial → gateway
Forward bounded USB serial frames to the authenticated loopback gateway. Credentials stay on the host for this USB path.
Owner's OLED kit passed USB tests · 12 October 2026
04Linux SDKLibrary + device agent
Declare your application's capabilities and connect it to the gateway. Includes the grok-linux-agent CLI and service setup.
Linux container verified · physical peripherals and systemd pending
05ESP32 SDKReusable firmware
A reusable capability SDK. The tested kit uses a YD-ESP32-23 v1.3 board and a 1.3-inch SH1106 OLED. The Wi-Fi path uses a pinned local CA and device token.
Owner's kit passed USB and Wi-Fi tests · independent reproduction pending
06Home AssistantIntegration diagnostics
Use Home Assistant's upstream MCP route for exposed entities. The read-only ha-probe tool checks the connection.
Fixture + loopback transport verified · live home and Grok pending
07Protocol contractsShared device language
Versioned capability, command, state and event frames. Bounded queues and restart cursors make recovery explicit.
Protocol 0.1.0 · gateway owns the contracts
08Developer & release toolsVerify + prepare
Hub checks are one command. Cross-repo integration is optional when the sibling clones sit next to this one.
Local tooling · publication requires separate approval
python3 scripts/dev.py check09Website & docsProject hub
Cloudflare Pages hosts the static website, docs and browser simulator. It does not run a gateway or device tunnel. Repository activity uses timestamped snapshots.
Static website active · no hosted gadget service
uv venv .venv --python 3.13
uv pip install --python .venv/bin/python -r website/requirements.txt
.venv/bin/python website/build.py
python3 -m http.server 4173 --bind 127.0.0.1 --directory website/dist10CommunityPolicies + recognition
Contribution guides, moderation plans, post drafts and an offline consent-based recognition evaluator for project contributors.
Offline recognition tested · community activation pending