# nodrix

> nodrix is an open-source, single-tenant IoT cloud that deploys to your own Cloudflare account. Hardware speaks plain HTTPS or WebSocket, telemetry streams to realtime drag-and-drop dashboards, automations run at the edge, and a clean read API exposes the data — with no broker, no servers, and your data never leaving your account.

## What it is
- Open-source (MIT) IoT backend for Cloudflare; first stable release (v1.0).
- Single-tenant: every deployment lives in the user's own Cloudflare account.
- One-click "Deploy to Cloudflare" — provisions Workers, Durable Objects, D1, R2, and KV.
- Devices send telemetry over plain HTTPS (POST /v1/telemetry) or a WebSocket (/v1/control/ws); variables auto-create on first sight. No MQTT broker, no SDK.
- Realtime dashboards built from drag-and-drop widgets over hibernating WebSockets.
- Two-way control: toggles/sliders/buttons write values back to hardware.
- Edge automations: a visual flow builder — one or more triggers (variable thresholds, schedules, sunrise/sunset, custom events) branch through conditions into actions (set variables, call an integration over HTTP/email/chat like Slack/Telegram/Discord, or emit events).
- Clean read API: edge-cached latest state, time-series, and variable listings behind one bearer token.
- Optional MCP (Model Context Protocol) server — owner-gated, off by default. Lets Claude, Claude Code, and any MCP-aware client read projects and (with an explicit toggle) drive automations. Bearer transport at /v1/mcp; OAuth at /v1/mcp/oauth.

## Pages
- [Home](https://nodrix.live/): Product overview, features, and how it works.
- [Documentation](https://nodrix.live/docs): Device protocol, read API, automation model, and MCP.
- [Widgets](https://nodrix.live/widgets): Built-in, framework-agnostic Web Component widgets.
- [Guides](https://nodrix.live/guides): Hands-on IoT guides — connect an ESP32 to the cloud over HTTPS (no MQTT broker), receive commands back, deep-sleep battery builds, and more.
- [Roadmap](https://nodrix.live/roadmap): What's planned next for nodrix.
- [Changelog](https://nodrix.live/changelog): Release history.

## Markdown & full text (for machines)
- [Full text](https://nodrix.live/llms-full.txt): The entire site in one document.
- [Home (markdown)](https://nodrix.live/index.md)
- [Docs (markdown)](https://nodrix.live/docs.md)
- [Widgets (markdown)](https://nodrix.live/widgets.md)

## Tech stack
- Cloudflare Workers, Durable Objects, D1, R2, KV.

## Source
- [GitHub repository](https://github.com/decoded-cipher/nodrix)
- License: MIT