Skip to content
A flexible data historian based on InfluxDB, Grafana, MQTT and more. Free, open, simple.
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.crossbar
clients
doc
etc
kotori Bump version: 0.22.6 → 0.22.7 Mar 5, 2019
packaging Fix Debian package dependencies, add missing package "python-certifi" Mar 4, 2019
.bumpversion.cfg Bump version: 0.22.6 → 0.22.7 Mar 5, 2019
.dockerignore
.gitignore Upgrade libraries Twisted, autobahn, crossbar, msgpack and influxdb Apr 4, 2016
CHANGES.rst Fix problem with time precision detection heuristics for ingress time… Mar 5, 2019
CONTRIBUTORS.rst Improve documentation once more Mar 3, 2019
LICENSE
MANIFEST.in Fix packaging re. missing resources Mar 31, 2017
Makefile Improve documentation once more Mar 4, 2019
README.rst
THIRD-PARTY-NOTICES.rst
agpl-3.0.txt Add license, tune packaging and package publishing, update documentation May 22, 2016
eupl-1.2.txt
requirements-dev.txt
requirements-release.txt
requirements.txt add release and documentation infrastructure through Makefile targets Nov 6, 2015
setup.py Bump version: 0.22.6 → 0.22.7 Mar 5, 2019

README.rst


Telemetry data acquisition and sensor networks for humans.

Kotori

Kotori is a flexible data historian based on InfluxDB, Grafana, MQTT and more. Free, open, simple.

It is a telemetry data acquisition, processing and graphing toolkit aiming to become a fully integrated data historian. It is being conceived to support scientific environmental monitoring through distributed sensor networks and likewise scenarios.


In a nutshell

About

  • Kotori is a multi-channel and multi-protocol data historian.
  • It's an infrastructure toolkit made of components for data acquisition, graphing and more.
  • The system is used for building flexible telemetry solutions in different scenarios. People are conceiving and building test benches and different kinds of sensor networks for environmental monitoring and beyond.
  • Built-in sensor adapters, flexible configuration capabilities, durable database storage and unattended graph visualization out of the box.
  • Integrates well with established hardware-, software- and data acquisition workflows through flexible adapter interfaces.

Explore

It's best to find out more about Kotori by looking at how others use it already. Enjoy reading.

Technologies

Kotori is based on a number of fine infrastructure components and technologies and supports a number of protocols in one way or another. Standing on the shoulders of giants.

Installation

Kotori can be installed through a Debian package, from the Python Package Index (PyPI) or from the Git repository. Please follow up to the corresponding installation instructions:

As Kotori is pretty heavy in respect to the number of software components it relies on, things sometimes break when trying to install its dependencies. In order to let us know about any problems you might encounter when installing Kotori, please don't hesitate to open an issue on GitHub.


¹ When choosing to install from the Debian package repository, you will also be able to receive appropriate Debian packages for Mosquitto, InfluxDB and Grafana through the DaqZilla package repository. This makes it easy to setup the complete DAQ system from a single package source.

² All of the Debian packages are available for amd64 and armhf architectures to support installations on RaspberryPi, Beaglebone, Odroid or similar ARM-based SBC machines.

Acknowledgements

Thanks to all the contributors of Kotori who got their hands dirty with it and helped to co-create and conceive it in one way or another. You know who you are.

Project information

About

These links will guide you to the source code of »Kotori« and its documentation.

Contributing

We are always happy to receive code contributions, ideas, suggestions and problem reports from the community.

So, if you'd like to contribute you're most welcome. Spend some time taking a look around, locate a bug, design issue or spelling mistake and then send us a pull request or create an issue.

Thanks in advance for your efforts, we really appreciate any help or feedback.

Licenses

This software is copyright © 2013-2019 The Kotori Developers. All rights reserved.

It is and will always be free and open source software.

Use of the source code included here is governed by the GNU Affero General Public License and the European Union Public License. Please also have a look at the notices about licenses of third-party components.

Troubleshooting

If you encounter any problems during setup or operations or if you have further suggestions, please let us know by opening an issue on GitHub or drop us a line at support@getkotori.org. Thanks already.

Note

If not already reading here, you might want to continue reading on Kotori's documentation space.


Have fun!

You can’t perform that action at this time.