🌿 Welcome to Oasis Climate

Oasis Climate is not just a smart thermostat; it is a system designed to understand your home before controlling it. By building a thermal Digital Twin, we simulate how your house reacts to weather and heating, finding the best strategy for your comfort. We believe in transparency over black boxes and in giving you the right data to make informed decisions. This documentation is your guide to understanding the physics, the logic, and the tools behind Oasis.

🚧 A Living Documentation

We are building this documentation with the same care we put into our code.
We believe that clear, honest documentation is essential to make the system truly useful for you. If you don't understand how it works, you can't trust it, and if you can't trust it, it won't help you.

This section is currently under active construction. We are adding new guides, technical deep-dives, and API references every week.

📚 Topics

Here is the structured path to master Oasis Climate:

1. Getting Started
   Start here. How to set up your account, configure your first home profile, and understand the basic dashboard.

2. The Digital Twin Model
   The core concept. Understand the math and physics behind the model, and how we estimate thermal inertia (C) and heat loss (K) from your data.

3. The Simulator
   Learn how to use our simulation engine to test scenarios. Understand the inputs (weather, physics) and how to interpret the results to choose the best strategy before connecting real hardware.

4. Thermostat Strategies
   A detailed look at the control logic available: from simple Hysteresis to predictive MPC and experimental AI agents. Learn when to use which.

5. Integrations & Home Assistant
   Connect Oasis to your ecosystem. We treat Home Assistant as a first-class citizen: read local sensors, expose advice as entities, and keep control local.

6. Data & Privacy
   Transparency on how your data is collected, stored, and used. We believe your home data belongs to you.

7. API Reference
   Technical reference for developers who want to build on top of Oasis or extract raw data.

8. Troubleshooting
   Solutions to common issues, model calibration tips, and error messages explained.

We hope these resources help you get the most out of Oasis Climate.
Start by exploring, simulating, and understanding.