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. Public HTTPS and Grok Bot use are unverified.
Local MCP verified · Grok Bot unverified
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, outside firmware.
Pseudo-terminal integration tested · physical USB pending
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 SDKC124 firmware
A reusable capability SDK with USB-first firmware for AtomS3 Lite C124. Start with its RGB LED and button.
Compiled + host-simulated · physical board 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