# Ambinet

> Ambinet is an open, private, hardware-anchored smart home ecosystem designed around local-first reliability, secure device identity, and calm living environments.

Ambinet separates its control plane from its device data plane. The platform is built around a FastAPI backend, PostgreSQL relational state, an EMQX MQTT broker, Flutter client applications, and ESP-IDF-based embedded firmware.

## Core Products & Hardware

* **Ambinet Plug**: Smart plug with power monitoring and local control.
* **Ambinet Switch**: Smart wall switch with physical controls and synchronized device state.
* **Ambinet Dimmer**: Smart phase-cut dimmer for adjustable lighting.
* **Ambinet Glow**: Smart ambient luminaire with tunable white and RGB lighting.
* **Ambinet Line**: Continuous LED lighting for architectural and accent applications.
* **Ambinet Halo**: Diffuse ambient lighting designed for background atmosphere.

Product hardware and specifications are under active development and may change as engineering validation progresses.

## Architecture & Security Principles

* **Separation of Concerns**: The FastAPI backend manages identity, authentication, device ownership, and relational topology while MQTT handles device messaging.
* **Local-First Operation**: The architecture is designed to minimize dependence on centralized cloud services and support local network operation.
* **Hardware-Anchored Identity**: Device identity is rooted in factory-provisioned cryptographic keys and Proof-of-Possession during device claiming.
* **Explicit Ownership**: Device ownership is represented by persistent claiming state in the backend.
* **Secure Provisioning**: BLE-based provisioning uses Espressif Protocomm security mechanisms for authenticated device onboarding.

## Technical Stack

* **Backend**: Python 3.12+, FastAPI, SQLAlchemy, PostgreSQL, Alembic.
* **Messaging**: MQTT over TLS through EMQX.
* **Mobile Client**: Flutter and Dart.
* **Firmware**: ESP-IDF and C.
* **Device Connectivity**: Wi-Fi and Bluetooth Low Energy.

## Quick Links

* [Official Website](https://ambinet.org/): English landing page and product showcase.
* [Persian Website](https://ambinet.org/fa/): Persian (Farsi) localized website.
* [GitHub](https://github.com/nariman-z): Public Ambinet source repositories.