Quick Start Guide
Ambianic is an award winning ambient intelligence platform. Ambianic's goal is to provide helpful and actionable observations in the context of home and business automation.
Ambianic has two major components: - Ambianic Edge: an IoT device with camera (or other sensors) and a built-in AI engine for local inference - Ambianic UI app - a front-end Progressive Web App to manage Ambianic Edge device(s) and view timeline events reported by Ambianic Edge.
Following is a high level diagram of a typical Ambianic deployment.
The simplest way to get started is to follow these steps:
If you prefer an alternative hosting platform for your Ambianic Edge device, keep reading about more advanced installation options.
If you are familiar with Docker you will be able to install Ambianic Edge in less than 5 minutes on almost any computer with x86 or ARM architecture. Follow the steps below:
Ambanic Edge Docker image
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.
Installer for Raspberry OS and Debian-like linux
We have a commodity script that will take care of installing and setting up your system. Run this line to setup
wget -qO - https://raw.githubusercontent.com/ambianic/ambianic-quickstart/master/installer.sh | sh
After the setup you can find the installation under
/opt/ambianic where you can find the configuration files and the data directory (under
Ambianic Pipeline configuration will be under
The Ambianic Edge CLI
The installer will start the service for you. To manage the runtime you can use the
ambianic command line. A few examples:
- Start, Stop or Restart with
ambianic [ start | stop | restart ]
- View the instance status with
- View logs with
- Open the UI (if you system has a GUI) with
- Upgrade the installation with
Ambianic UI app
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.
IYou can now head to the Timeline view and you will be able to see an image of what is in front of the Ambianic Box. The box is pre-configured to detect people and over 20 kinds of objects. Detections will show in your timeline.
Congratulations! Your Ambianic instance is now up and running!
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.
When you are ready to explore more advanced capabilities, continue to the next section.
Ambianic provides flexible configuration options via a configuration YAML file. You can customize: pipelines, input sources, AI models, notification channels and more.
Read on: Configuring Ambianic Edge.
If you want to contribute to the code read how to setup a development environment
Supporting the project
If you find value in this project, consider supporting its future success. See the sustainability section.