Made by @adidshaft ↗

Grok Bot is made by SpaceXSI.
Grok Gadgets is an independent project.

↗

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.

See how they connect ↗
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.demo
03USB 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 check
09Website & 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/dist
10CommunityPolicies + recognition

Contribution guides, moderation plans, post drafts and an offline consent-based recognition evaluator for project contributors.

Offline recognition tested · community activation pending