OPEN SOURCE / LOCAL ALPHA
Grok, meet
the real world.
An open system for your devices.
Try & customizeLED off · 0 button events · connected
Browser simulation · no Grok calls No physical device connected.
NO HARDWARE REQUIRED
Make it yours.
Try a virtual light here.
Take the same setup to your Grok Bot.
Customize your virtual device ↗
See commands & state +
Ready · browser simulation
Latest report
No command yet.Virtual device state
WITH YOUR GROK BOT
Your own simulator.
Open source. Inspect it, install it, then ask Grok to control your virtual light.
Requires a supported Command MCP connection. No hardware. No API key in the file.
Alpha 0.1.0a1 · build dc9994ee · source tests + installed MCP checks passed
Above: browser simulation, with no Grok calls. Kit: real MCP software with a simulated device. Native Grok invocation evidence, mobile and physical verification remain pending.
FIVE REPOSITORIES / ONE PROJECT
The whole
toolkit.
SDKs, connections and tools.
Pick a part to explore.
01GatewayMCP + transports
Connect Grok tools to registered devices. Discover capabilities, route commands and read execution reports.
Local MCP verified · native Grok receipts pending
02SimulatorNo hardware needed
Try the virtual light here, customize it, then take its configuration to your Grok Bot.
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
Run acceptance checks, audit source history, export labeled issues and assemble unpublished release artifacts.
Local tooling · publication requires separate approval
.venv/bin/python scripts/check-all.py
python3 scripts/audit.py
python3 scripts/export-roadmap.py
python3 scripts/prepare-issue-migration.py
python3 scripts/import-component-docs.py
python3 scripts/package-local.py09Website & docsProject hub
Build this static site from canonical component documentation and the issue ledger. Activity refresh stays inactive until approval.
Local build verified · public activity unavailable
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