5 Minute Quick Start
Ambianic's goal is to provide helpful and actionable suggestions in the context of home and business automation.
Ambianic has two major components: Ambianic UI and Ambianic Edge.
Ambianic UI is pre-deployed and readily available at https://ui.ambianic.ai. If you are familiar with Docker you will be able to install Ambianic Edge in less than 5 minutes. Let's go step by step.
Ambianic Edge is available as a docker image for ARM and x86 architectures so it can be deployed on most modern machines and operating systems.
Feel free to use this shell script provided by Luca Capra that installs Docker and Docker Compose on a Raspberry Pi system (or another Debian flavored Linux) and runs a minimal Ambianic Edge configuration.
Starting Ambianic Edge
Here is a default docker-compose.yaml file that you can start with. It takes care of monitoring the health of Ambianic Edge, restarting when necessary and also graceful automatic updates to the latest release within 5 minutes.
Note: The very first time you start Ambianic Edge it may take a minute or two. You will then see an error message that configuration file could not be found. Worry not. We will address that in due course. Let's get the base system running first. Then we will come back to configuration settings.
Ambianic UI is a modern prorgressive web application (PWA) that provides Plug-and-Play pairing and remote access to an Ambianic Edge device.
Ambianic UI shows a timeline view with important events around your home organized chronologically. Below is an example timeline screenshot.
Pairing Ambanic UI with Ambianic Edge
You can easily pair up your Ambianic UI with Ambianic Edge. It works similar to Airdrop.
Make sure to open Ambianic UI on the same local network where Ambianic Edge runs. Ambianic UI will initially display a welcome screen.
If you click on Settings, it will show a pairing page like the one below:
After a few moments, pairing will conclude and you will see the unique identifier of your Ambianic Edge device.
Congratulations! Your Ambianic instance is now up and running!
You are now ready to configure Ambianic: pipelines, input sources and AI models.
Read on: Configuring Ambianic Edge.
Once you configure Ambianic Edge and restart the docker image, you should be able to see timeline view like the one above.
The pairing information is persisted on your Ambianic UI client device and you can now access Ambianic Edge from anywhere remotely! The connection is direct and encrypted end-to-end.
Supporting the project
If you find value in this project, consider supporting its future success. See the sustainability section.