This project represents the custom-built smart home. Functionalities are currently limited to interfacing with lights, but this project aims to run all possible aspects of my home as I grow older.

Jarvis was built with python3.9, sqlite3, and Docker for deployment and VM management.

First install dependencies:

    python3 -m pip install -r brain/requirements.txt

To run Jarvis, awake with by running the awake.py shell script

Run Jarvis in Development Mode:

    python3 awake.py --env development

Run Jarvis in Production

    python3 awake.py --env production 

Run Jarvis w/out the Server

    python3 awake.py --env development --no-server

Jarvis' folder structure is broken down below:

• DB - All database configuration for the sqlite database used to store Jarvis & device state
• Models - Custom python models used to type custom data structures and provide ENUMs for commonly used structs
• Services - Reusable services specific to functionalities

Jarvis is deployed via Github Actions. The deployment script can be found in .github/workflows/deploy-jarvis.yml

Running the server locally will produce logs in the console, but running the Docker container will produce logs in the filesystem.

View logs in production

    docker logs jarvis --follow

In the rare case, you may also need to build and run Jarvis' docker container locally in your development environment. For this, use the commands below.

Build Jarvis' Docker Image

    sudo docker build . -f brain/Dockerfile -t local_test --build-arg AUTH_TOKEN=hey

Run a Jarvis Docker Container

    sudo docker run --rm --network host --device /dev/snd local_test

View logs in test build

    docker logs local_test --follow