# AetherIoT

> Open-source edge, cloud, and interoperability building blocks for reliable IoT systems.

Documentation pages are available as Markdown. Append `.md` to any document URL or send `Accept: text/markdown`.

## Overview

- [Deployment topologies](https://docs.aetheriot.workers.dev/en/overview/deployment-topologies): AetherIoT supports deployments that keep physical authority at the edge while adding cloud coordination only where it creates value.
- [AetherIoT platform overview](https://docs.aetheriot.workers.dev/en/overview/platform): AetherIoT is the open-source project identity for a family of interoperable, edge-first IoT products. It is not a fourth runtime and does not own a…
- [Typical user journeys](https://docs.aetheriot.workers.dev/en/overview/user-journeys): Choose the shortest path that matches your role. All write paths remain governed and deny by default.

## AetherEdge

- [AetherEdge](https://docs.aetheriot.workers.dev/en/aetheredge): AetherEdge is the open-source, industry-neutral Linux edge runtime, Kernel, CLI, and Rust SDK formerly published from the AetherIot repository name.
- [Agent Quickstart](https://docs.aetheriot.workers.dev/en/agent-quickstart): Install the AetherEdge Skill, start a safe-empty runtime, and connect an AI agent from zero.
- [System Architecture](https://docs.aetheriot.workers.dev/en/concepts/architecture): Isolated edge services communicating over shared memory, per-consumer UDS events, SQLite, HTTP, and MQTT
- [Data Flow](https://docs.aetheriot.workers.dev/en/concepts/data-flow): SHM-native uplink and downlink paths end to end, with latency budgets
- [Data Model](https://docs.aetheriot.workers.dev/en/concepts/data-model): Products, instances, and T/S/C/A points - and why an instance is a pure thing-model with no status field
- [Data Processing Flow](https://docs.aetheriot.workers.dev/en/concepts/data-processing-flow): How Aether assembles governed IoT data, invokes a request-driven processor, validates derived data, and keeps control separate
- [Aether Data Processing](https://docs.aetheriot.workers.dev/en/concepts/data-processing): Industry-neutral, request-driven processing of governed IoT data into validated derived data
- [Rule Engine](https://docs.aetheriot.workers.dev/en/concepts/rule-engine): Dual-column rule storage, tick and event scheduling, execution, and hot reload
- [Shared Memory](https://docs.aetheriot.workers.dev/en/concepts/shared-memory): The SHM data plane - slot layout, writer ownership, seqlock reads, generations, and the PointWatch event plane
- [aether-application](https://docs.aetheriot.workers.dev/en/crates/aether-application): Transport-neutral command and query use cases for the Aether edge kernel.
- [aether-cloudlink](https://docs.aetheriot.workers.dev/en/crates/aether-cloudlink): Transport-neutral implementation of the experimental, digest-pinned public AetherContracts CloudLink subset. It provides strict closed JSON decoding,…
- [Aether Data Processing](https://docs.aetheriot.workers.dev/en/crates/aether-data-processing): Strict, transport-neutral JSON codec for the Aether Data Processing v1 processor boundary. It converts validated domain values to and from the versioned…
- [aether-dataplane](https://docs.aetheriot.workers.dev/en/crates/aether-dataplane): `aether-dataplane` is Aether's business-neutral shared-memory core. It can be used by an embedded gateway without Redis, PostgreSQL, SQLx, routing…
- [aether-domain](https://docs.aetheriot.workers.dev/en/crates/aether-domain): Industry-neutral, `no_std` domain types for the Aether edge kernel.
- [aether-pack](https://docs.aetheriot.workers.dev/en/crates/aether-pack): Versioned, industry-neutral domain-pack manifest loading for the Aether edge kernel. The crate validates a pack's own release identity, distribution…
- [aether-ports](https://docs.aetheriot.workers.dev/en/crates/aether-ports): Small, object-safe capability interfaces for Aether edge extensions.
- [aether-edge-sdk](https://docs.aetheriot.workers.dev/en/crates/aether-sdk): Versioned beta facade for embedding the Aether AI-native IoT edge kernel.
- [aether-testkit](https://docs.aetheriot.workers.dev/en/crates/aether-testkit): Reusable conformance checks and deterministic test doubles for Aether extension authors.
- [aether-cloudlink-mqtt](https://docs.aetheriot.workers.dev/en/extensions/cloudlink-mqtt): Broker-neutral MQTT v3.1.1/QoS 1 binding for the experimental CloudLink edge foundation. It validates a user-selected endpoint, TLS/authentication…
- [Aether HTTP Data Processor](https://docs.aetheriot.workers.dev/en/extensions/http-data-processor): Optional, bounded HTTP implementation of the `DataProcessor` port. It sends a complete request frame to `/v1/process`; it exposes no callback into…
- [Aether HTTP History Query](https://docs.aetheriot.workers.dev/en/extensions/http-history-query): This optional extension maps semantic Data Processing history features to a loopback-only batch endpoint containing an already materialized cadence…
- [aether-postgres-history](https://docs.aetheriot.workers.dev/en/extensions/postgres-history): Optional PostgreSQL implementation of Aether's append-only history capability.
- [aether-redis-bridge](https://docs.aetheriot.workers.dev/en/extensions/redis-bridge): Optional, non-authoritative Redis mirror for Aether point state.
- [aether-shm-bridge](https://docs.aetheriot.workers.dev/en/extensions/shm-bridge): Read-only capability bridge from Aether's authoritative shared-memory data plane to the public `LiveState` port.
- [Aether SQLite History Query](https://docs.aetheriot.workers.dev/en/extensions/sqlite-history-query): Production `HistoryQuery` adapter for the embedded SQLite file owned by `aether-history`. It reads the existing table:
- [aether-store-local](https://docs.aetheriot.workers.dev/en/extensions/store-local): Local adapters for a gateway that must run without external services.
- [Connect AI Assistants](https://docs.aetheriot.workers.dev/en/guides/ai-assistants): Point Claude or any MCP client at aether mcp, and choose between read-only and write access
- [Build Applications with AI](https://docs.aetheriot.workers.dev/en/guides/build-applications-with-ai): Generate contract-first IoT applications without turning a Web UI or an AI agent into a second runtime authority
- [Connect Devices](https://docs.aetheriot.workers.dev/en/guides/connect-devices): Configure channels, choose protocols, and map device points to instances
- [Connect Data Processors](https://docs.aetheriot.workers.dev/en/guides/data-processors): Declare data-processing tasks in domain packs and connect request-driven local or remote processors
- [Deployment](https://docs.aetheriot.workers.dev/en/guides/deployment): Run with Docker Compose or build a self-contained installer for edge devices
- [Getting Started](https://docs.aetheriot.workers.dev/en/guides/getting-started): Build the workspace, initialize configuration, start services, and verify health
- [Safe Operations for Applications and Agents](https://docs.aetheriot.workers.dev/en/guides/safe-operations): Preserve identity, confirmation, audit, topology fencing, and uncertain command outcomes when operating AetherEdge
- [Writing Rules](https://docs.aetheriot.workers.dev/en/guides/writing-rules): Author rules through the HTTP API or a downstream product console
- [CLI Reference](https://docs.aetheriot.workers.dev/en/reference/cli): Every aether command - services, sync, doctor, channels, rules, and more
- [Experimental CloudLink MQTT v1 edge contract](https://docs.aetheriot.workers.dev/en/reference/cloudlink-mqtt-v1): This document describes the experimental CloudLink candidate. The public AetherContracts `v0.1.0-alpha.3` release is the sole authority, and AetherEdge…
- [Configuration Reference](https://docs.aetheriot.workers.dev/en/reference/configuration): YAML configuration schema, the sync pipeline, and environment variables
- [Data Processing Contracts](https://docs.aetheriot.workers.dev/en/reference/data-processing-contracts): Version 1 contracts for processing frames, requests, derived results, validation, and failure semantics
- [HTTP API](https://docs.aetheriot.workers.dev/en/reference/http-api): The single remote gateway, service-local OpenAPI, authentication, and compatibility conventions
- [MCP Tools Reference](https://docs.aetheriot.workers.dev/en/reference/mcp-tools): All MCP tools grouped by domain, with parameters and write-safety markers
- [Dependency security exceptions](https://docs.aetheriot.workers.dev/en/security/dependency-exceptions): Security advisories are denied by default. An exception is permitted only when the affected operation is unreachable, the boundary is enforced in code…

## AetherCloud

- [Architecture](https://docs.aetheriot.workers.dev/en/aethercloud/concepts/architecture): Understand the modular-monolith processes, dependency direction, and evolution rules
- [Artifact registry and immutable publication](https://docs.aetheriot.workers.dev/en/aethercloud/concepts/artifact-registry): Publish signed content-addressed revisions without confusing release metadata, deployment intent, or edge acceptance
- [Audit, subscriptions, webhook delivery, and data export](https://docs.aetheriot.workers.dev/en/aethercloud/concepts/audit-and-integrations): Expose Tenant-scoped evidence and durable integration workflows without bypassing application use cases or leaking destination secrets
- [CloudLink reliability and lifecycle](https://docs.aetheriot.workers.dev/en/aethercloud/concepts/cloudlink-and-core-state-machines): Understand delivery, retries, acknowledgements, offline recovery, and current production limits
- [Desired, Reported, and Applied deployment](https://docs.aetheriot.workers.dev/en/aethercloud/concepts/desired-reported-applied-deployment): Roll out immutable artifact intent without treating dispatch, connection, or timeout as edge application evidence
- [Edge, AetherCloud, and provider authority](https://docs.aetheriot.workers.dev/en/aethercloud/concepts/edge-cloud-boundary): Assign live, desired, and actual state across edge runtimes, AetherCloud, and infrastructure providers
- [Gateway identity and enrollment](https://docs.aetheriot.workers.dev/en/aethercloud/concepts/gateway-identity-and-enrollment): Build tenant-scoped Gateway identity from registration and short-lived bootstrap claims
- [Governed capability Jobs](https://docs.aetheriot.workers.dev/en/aethercloud/concepts/governed-capability-jobs): Request versioned edge capabilities without arbitrary RPC, unsafe retry, or cloud claims about physical outcomes
- [IoT Cloud capability map](https://docs.aetheriot.workers.dev/en/aethercloud/concepts/iot-cloud-capability-map): Map AetherCloud bounded contexts, authority, use cases, storage, edge interaction, risk, and delivery phase
- [IoT business telemetry](https://docs.aetheriot.workers.dev/en/aethercloud/concepts/iot-telemetry): Document replay-safe PostgreSQL telemetry acceptance and exact CloudLink ACK delivery without replacing edge live-state authority
- [MCP application interface](https://docs.aetheriot.workers.dev/en/aethercloud/concepts/mcp-application-interface): Expose capability metadata, Tenant resources, and governed tools through the same application use cases without creating an agent-only data path
- [Multi-cloud fusion](https://docs.aetheriot.workers.dev/en/aethercloud/concepts/multi-cloud-fusion): Unify cloud lifecycle and policy without erasing provider capabilities or sharing one global state
- [Operational observability](https://docs.aetheriot.workers.dev/en/aethercloud/concepts/operational-observability): Instrument AetherCloud with OpenTelemetry without turning operational signals into IoT data or audit
- [PostgreSQL persistence and multi-cloud cells](https://docs.aetheriot.workers.dev/en/aethercloud/concepts/persistence-and-multi-cloud-cells): Place Gateway and telemetry transactional authority in one portable PostgreSQL cell while evolving analytics and provider profiles independently
- [Resource model](https://docs.aetheriot.workers.dev/en/aethercloud/concepts/resource-model): Use cloud connection, deployment stack, fleet, and edge resource vocabulary consistently
- [AetherIoT product family](https://docs.aetheriot.workers.dev/en/aethercloud/get-started/aetheriot-product-family): Place AetherCloud beside AetherEdge and AetherContracts without blurring edge, cloud, provider, or protocol authority
- [AetherCloud overview](https://docs.aetheriot.workers.dev/en/aethercloud/get-started/overview): Understand the multi-cloud product, its authority boundaries, and the first vertical slices
- [Add a Provider Adapter](https://docs.aetheriot.workers.dev/en/aethercloud/guides/add-provider-adapter): Implement provider discovery behind the application port and prove it with the shared conformance suite
- [Build with an AI agent](https://docs.aetheriot.workers.dev/en/aethercloud/guides/build-with-an-agent): Use repository contracts and verification commands without inventing unsupported APIs
- [IoT Cloud vertical-slice roadmap](https://docs.aetheriot.workers.dev/en/aethercloud/guides/iot-cloud-roadmap): Deliver AetherCloud product value through independently testable cloud-edge slices
- [Plan infrastructure safely](https://docs.aetheriot.workers.dev/en/aethercloud/guides/plan-infrastructure): Run the implemented governed OpenTofu Plan worker without implying infrastructure mutation or exposing sensitive engine output
- [AetherCloud](https://docs.aetheriot.workers.dev/en/aethercloud): AetherCloud is the AI-native, industry-neutral, multi-cloud IoT fusion and control plane for AetherEdge runtimes and cloud-side workloads. It is a…
- [Application contract catalog](https://docs.aetheriot.workers.dev/en/aethercloud/reference/application-contracts): Discover capability governance, errors, events, HTTP operations, and implementation layers from one machine-readable catalog
- [Pre-release CloudLink MQTT v1](https://docs.aetheriot.workers.dev/en/aethercloud/reference/cloudlink-mqtt-v1): Review alpha.3 Broker evidence and the PostgreSQL telemetry ACK slice without overstating full CloudLink authentication or crash durability
- [HTTP API reference](https://docs.aetheriot.workers.dev/en/aethercloud/reference/http-api): Call the implemented HTTP endpoints and distinguish them from planned versioned APIs
- [Repository layout](https://docs.aetheriot.workers.dev/en/aethercloud/reference/repository-layout): Place code in the correct application, domain, adapter, or composition-root package
- [Terminology](https://docs.aetheriot.workers.dev/en/aethercloud/reference/terminology): Resolve AetherCloud terms before naming contracts or database records

## AetherContracts

- [Product naming migration](https://docs.aetheriot.workers.dev/en/aethercontracts/migration): AetherIoT is the umbrella project for AetherEdge, AetherCloud, and AetherContracts. The edge product and repository formerly named AetherIot move to…
- [AetherContracts compatibility and release gates](https://docs.aetheriot.workers.dev/en/aethercontracts/compatibility): Distinguish the alpha.3 compatibility baseline from authentication, durability, and legacy-cutover gates that remain open
- [Conformance and consumer verification](https://docs.aetheriot.workers.dev/en/aethercontracts/conformance): Understand what the AetherContracts TCK proves, how bindings report evidence, and how consumers verify an exact release closure
- [Get started with AetherContracts](https://docs.aetheriot.workers.dev/en/aethercontracts/getting-started): Select the exact experimental release, navigate the contract layers, run the TCK, and adopt a digest-pinned consumer closure
- [AetherContracts](https://docs.aetheriot.workers.dev/en/aethercontracts): AetherContracts is the public, language-neutral interoperability authority for AetherEdge, AetherCloud, and independent implementations.
- [AetherContracts C foundation](https://docs.aetheriot.workers.dev/en/aethercontracts/packages/c): The C99 foundation is allocation-free and uses caller-owned string views. It currently provides canonical `uint64` parsing plus static Thing Model…
- [AetherContracts C++ foundation](https://docs.aetheriot.workers.dev/en/aethercontracts/packages/cpp): The C++17 target `AetherContracts::cpp` is a thin, non-owning wrapper over the C99 core. It does not implement a second parser or protocol contract.…
- [aether-contracts](https://docs.aetheriot.workers.dev/en/aethercontracts/packages/rust): Experimental Rust foundation binding for AetherContracts. It currently provides canonical `u64` parsing with language-neutral failures and executes the…
- [@aether-contracts/typescript](https://docs.aetheriot.workers.dev/en/aethercontracts/packages/typescript): Experimental TypeScript foundation binding for AetherContracts. It currently provides canonical `uint64` parsing and RFC 8785-compatible JSON…
- [CloudLink v1 alpha 1](https://docs.aetheriot.workers.dev/en/aethercontracts/spec/cloudlink-v1alpha1): AetherContracts is the sole interoperability authority for this protocol slice. Product-repository wire profiles, manifests, gates, and evidence files…
- [Consumer distribution v1 alpha 1](https://docs.aetheriot.workers.dev/en/aethercontracts/spec/distribution-v1alpha1): This profile lets AetherCloud, AetherIot, and independent implementations pin one exact AetherContracts release while keeping their default verification…
- [Contract foundation](https://docs.aetheriot.workers.dev/en/aethercontracts/spec/foundation): The v1 alpha logical representation and wire encoding are UTF-8 JSON. Closed core objects reject unknown fields. A conformant raw decoder must also…
- [Language-neutral TCK v1 alpha 1](https://docs.aetheriot.workers.dev/en/aethercontracts/spec/tck-v1alpha1): Repository tests compile every normative JSON Schema, validate valid and wire-invalid fixtures, preserve context-invalid distinctions, and verify every…
- [Thing Model v1 alpha 1](https://docs.aetheriot.workers.dev/en/aethercontracts/spec/thing-model-v1alpha1): A Thing Model is an immutable, industry-neutral definition. It describes configuration properties, edge-observed points, and governed capabilities. It…

## Tutorials

- [Connect AetherEdge to AetherCloud through AetherContracts](https://docs.aetheriot.workers.dev/en/tutorials/edge-contracts-cloud): This tutorial proves the current cross-repository integration path without claiming production CloudLink readiness. It starts with a safe local runtime,…

## Compatibility

- [Product version compatibility](https://docs.aetheriot.workers.dev/en/compatibility/version-matrix): This matrix distinguishes released compatibility evidence from planned product combinations. A green local test never upgrades an experimental public…

## Roadmap

- [Platform status and roadmap](https://docs.aetheriot.workers.dev/en/roadmap/status): Status is reported separately for implemented, experimental, and planned capabilities. Product names do not upgrade technical readiness.

## Migration

- [Migrate from AetherIot to AetherEdge](https://docs.aetheriot.workers.dev/en/migration/aetheriot-to-aetheredge): The edge product and repository are renamed from AetherIot to AetherEdge. AetherIoT becomes the umbrella project name for AetherEdge, AetherCloud, and…