Telemetry data acquisition and sensor networks for humans.
- Status:
-
- Usage:
-
- Compatibility:
-
About
Kotori is a multi-channel, multi-protocol telemetry data acquisition and graphing toolkit for time series data processing also known as data historian.
It supports a variety of scenarios in scientific environmental monitoring projects, for building and operating distributed sensor networks, and for industrial data acquisition applications.
Details
Kotori is a data and protocol broker within SCADA / MDE systems, exclusively built upon industry-grade free and open-source software like Grafana, Mosquitto, or InfluxDB. It is written in Python, and uses the Twisted networking library.
The best way to find out what you can do with Kotori, is by looking at some outlined scenarios and by reading how others are using it at the example gallery. To learn more about the technical details, have a look at the used technologies.
Features
Multi-channel and multi-protocol data-acquisition and -storage. Collect and store sensor data from different kinds of devices, data sources, and protocols.
Built-in sensor adapters, flexible configuration capabilities, durable database storage and unattended graph visualization.
Based on an infrastructure toolkit assembled from different components suitable for data-acquisition, -storage, -fusion, -graphing and more.
Leverage the flexible data acquisition integration framework for building telemetry data acquisition and logging systems, test benches, or sensor networks for environmental monitoring systems, as well as other kinds of data-gathering and -aggregation projects.
It integrates well with established hardware-, software- and data acquisition workflows through flexible adapter interfaces.
Installation
Kotori can be installed in different ways, see all installation options. You may prefer using a Debian package, install it from the Python Package Index (PyPI), or run it within a development environment directly from the Git repository, see sandbox installation instructions.
Synopsis
A compact example how to submit measurement data on a specific channel, using MQTT and HTTP, and export it again.
Data acquisition
First, let’s define a data acquisition channel:
CHANNEL=amazonas/ecuador/cuyabeno/1
and some example measurement data:
DATA='{"temperature": 42.84, "humidity": 83.1}'
Submit with MQTT:
MQTT_BROKER=daq.example.org echo "$DATA" | mosquitto_pub -h $MQTT_BROKER -t $CHANNEL/data.json -l
Submit with HTTP:
HTTP_URI=https://daq.example.org/api/ echo "$DATA" | curl --request POST --header 'Content-Type: application/json' --data @- $HTTP_URI/$CHANNEL/data
Data export
Measurement data can be exported in a variety of formats.
This is a straight-forward example for CSV data export:
http $HTTP_URI/$CHANNEL/data.csv
Acknowledgements
Thanks a stack to all the contributors who helped to co-create and conceive Kotori in one way or another. You know who you are.
Project information
Contributions
Every kind of contribution, feedback, or patch, is much welcome. Create an issue or submit a patch if you think we should include a new feature, or to report or fix a bug.
Development
In order to setup a development environment on your workstation, please head over to the development sandbox documentation. When you see the software tests succeed, you should be ready to start hacking.
Resources
License
The project is licensed under the terms of the GNU AGPL license, see LICENSE.
Supported by
Special thanks to the people at JetBrains s.r.o. for supporting us with excellent development tooling.
1 maintainer
Release files for kotori 0.28.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| kotori-0.28.1.tar.gz | 479.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| kotori-0.28.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 669.1 kB
Release files / kotori-0.28.1.tar.gz
| Download URL | kotori-0.28.1.tar.gz |
|---|---|
| Size | 479.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
427ee80e9583d5ccac29804d31069845d90151eee7e57810ba669634858f45f8
|
|
BLAKE2b-256 checksum How to use checksums |
ba21c43da724ebea1a09a15cf17f3436a83d088720daa7edb3583878c0c82d02
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
Release files / kotori-0.28.1-py3-none-any.whl
| Download URL | kotori-0.28.1-py3-none-any.whl |
|---|---|
| Size | 189.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4c92001a73fa14d7797e251bf0bcd0a8ca1ced8ad2cc18183af7107e22f26ab4
|
|
BLAKE2b-256 checksum How to use checksums |
f467bc2c3652798d122910e40772b2fe5eedcd856bacf0645fc85171e1e80cdb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
