Kauri is a cloud based system for monitoring your off-grid energy systems.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
common/models
docs
frontend
server
services
.editorconfig
.gitignore
.jshintignore
.jshintrc
.yo-rc.json
Gruntfile.js
LICENSE
README.md
nodemon.json
package-lock.json
package.json
pm2.json
ubuntu-install.sh

README.md

What is this?

Kauri is a cloud based system for monitoring your off-grid energy systems. It consists of several components including the software which interacts with your energy sensors, the server that collects and processes your data, and the frontend which lets you view all your data from any internet connected device.

The Kauri status page.

Features

  • Collect data from energy sensors on-site and store them in the cloud. This means you can access your sensor data from anywhere in the world!

  • Calculate the state of charge of the battery using the B42SOC algorithm. This lets you better plan when you need to use a generator. Kauri also provides a full history of the state of your system to track trends over time. The state of charge graph

  • Get information about the energy provided from each of your energy sources. This means you can identify exactly how much energy your solar generation provides in comparison to wind, etc. The energy sources graph

  • Get information about the consumption of the building.

  • Predicts the future state of the system using historical data through several methods of prediction patterns. The future states page in Kauri showing the future state of the system.

  • View the live status of the energy system, including the current energy flows, state of charge and future state of the system.

  • Highly configurable - tweak everything from the low voltage trigger time to the colour of your solar generation in graphs.

  • Support for as many buildings as you need on a single Kauri server.

  • Support for multiple bridge clients per building.

  • Full user management - users can create accounts for others and give others access to their buildings.

Components of Kauri

A diagram of the components of Kauri.

This project contains the frontend and backend components of Kauri.

The Kauri Bridge project is also available on GitHub.

Read more about the development of Kauri in "Monitoring an off-grid system with Kauri"

What do I need?

There are quite a few moving parts involved in Kauri. Before you get started, be sure to check you have everything you need.

If you just want to have a play with Kauri for now, there are options to work with example datasets and on your local system, so keep reading!

Setting up

See the setting up guide for information on how to get Kauri running in your development or production environment.

Getting started

See the getting started guide to learn how Kauri works and get Kauri collecting, processing and predicting the future using your data.

API Documentation

When you have an instance of the API running you can access the StrongLoop API Explorer at http://localhost:3000/explorer to experiment with the API.

Contributing

I am not actively developing this project but if you find a bug or anything that could make the system better, please raise an issue on GitHub.

Even better, if you have a chance, feel free to fork the repository, make your change and open a merge request to have it merged in.

Licence

MIT