System Architecture

Built on modern, open-source foundations for robustness and scale.

Oasis Climate is designed as a modular monolith with a clear separation of concerns between data ingestion, decision logic, and user interface.

High-Level Layers

API Layer (FastAPI): Handles secure communication with IoT devices and the user dashboard.
Worker Layer (Celery): Performs heavy computations, simulations, and background tasks asynchronously.
Domain Core: Pure Python logic containing the physics engine and agent strategies, decoupled from the web framework.

Data Flow

Data flows from your home to our secure cloud, where it is processed to update your home's Digital Twin.

Sensor -> API -> Time Series DB -> Physics Engine -> Simulation -> Advice

Decoupling

We strictly separate simulation from control. The decision engine never acts directly on the hardware; it produces a plan or advice which is then verified before being sent to the device (in Active mode) or the user (in Advisory mode).