.. include:: _resources.rst .. swarm.hiveeyes.org documentation master file, created by sphinx-quickstart on Tue Jan 26 00:00:38 2016. You can adapt this file completely to your liking, but it should at least contain the root `toctree` directive. .. _hiveeyes-system: ################################# The Hiveeyes system documentation ################################# .. highlight:: bash Welcome to the jungle. .. toctree:: :maxdepth: 1 :hidden: News goals labhive-one handbook do-it-yourself setup-backend development research other-projects Changelogs people contact LICENSE terms .. contents:: :local: :depth: 1 ---- ***** About ***** In a nutshell ============= The Hiveeyes project is developing a flexible toolkit for beehive monitoring. We aim at making non-invasive beekeeping as affordable and comfortable as possible by supporting the beekeeper community with an open, universal, do-it-yourself telemetry infrastructure platform for data collection to streamline the process of raw data acquisition when developing individual beehive monitoring solutions. The toolkit uses low-cost, low-power hardware and contemporary software components. All our hardware and software is available under free software and similar licenses to encourage the growth of an open ecosystem. For further details, please see the projects' :ref:`goals`. There are :ref:`other-projects` around the world sharing similar ambitions, we are loosely in touch with them. Please also have a look under the hood at our detailed :ref:`project news ` page. .. _project-origin: Who is behind Hiveeyes? ======================= We are a group of beekeepers from Berlin regularly meeting on wednesdays. We are Karsten, Robert, Clemens, Nik, Richard, Martin, Andreas and Dazz. Feel welcome to `join us `_. The community project originated from the independent `Open Bee Hive`_, `Open Hive`_, `Hiveeyes `_ and `Hive Monitor`_ beehive monitoring projects. `Clemens Gruber`_ of :ref:`open-hive` and Markus Euskirchen of `Open Bee Hive`_ started their work on low-cost, low-power, DIY beehive monitoring solutions in 2011 already and Clemens keeps being a driving force behind this project. `Karsten Harazim`_ (`facebook `_) aka. `Beutenkarl`_ (`facebook `_) and the `solidary apiculture mauergarten `_ (`facebook `_, `bienenblog`_) was one of the major catalysts for bringing us together as a community in 2014. On the tech side, the project is one of the many spin-offs of the popular Arduino Forum thread `Measuring the weight of a beehive`_. *********** Impressions *********** Some pictures from the trenches. .. figure:: https://ptrace.hiveeyes.org/2016-02-18_HEnode-field-01.jpg :alt: HEnode version 0.2.2 in the field :width: 275px :align: left .. figure:: https://ptrace.hiveeyes.org/2016-05-25_Scale%20Frame%20-%2001%20-%20Beutenkarl.jpg :alt: Scale Frame "Beutenkarl" :width: 275px :align: left .. figure:: https://ptrace.hiveeyes.org/2016-05-25_Scale%20Frame%20-%2005%20-%20Ready%2C%20Back.jpg :alt: Scale frame is mounted. Rear view. :width: 275px :align: left |clearfix| .. figure:: https://ptrace.hiveeyes.org/2016-07-08_open-hive_box-with-electronics.jpg :alt: Open Hive Box :width: 275px :align: left .. figure:: https://ptrace.hiveeyes.org/2016-06-17_openhive-beescale-assembled.jpg :alt: Open Hive Scale :width: 275px :align: left .. figure:: https://ptrace.hiveeyes.org/2016-09-03_Harvesting_2016-05.jpg :alt: Data display. :width: 275px :align: left |clearfix| .. _platform: .. _Hiveeyes platform: **************** Backend platform **************** The Hiveeyes backend platform ``swarm.hiveeyes.org`` is composed of open source software components like Grafana_, InfluxDB_, `Eclipse Mosquitto`_, Kotori_ and mqttwarn_, providing an instant-on experience for data collection, visualization and alerting. The data collection platform is voluntarily operated by the beekeeper community, it always runs on the most recent stable release of each software component while we are making sure all parts fit together well. All collaborative efforts integrated into the platform will be available to all of its users. Enjoy having all upstream changes and new features available without thinking about backups, maintenance and upgrade procedures. *************** Getting started *************** For sending data to the Hiveeyes platform ``swarm.hiveeyes.org``, please read the :ref:`platform-services` and :ref:`data-acquisition` documentation pages. ************** Do it yourself ************** All hardware and software components are developed completely in the open to encourage building and operating custom monitoring infrastructure based on these technologies. For getting into the details, please read the :ref:`do-it-yourself` page or `get in touch with us `_. We don't have a shiny tutorial yet, but there are many components to build upon. For sending data to a self-operated backend, please have a look at the :ref:`backend-setup` page. If you feel there should be features X and most importantly Y, just let us know about your specific needs and requirements. *********** Development *********** We are always happy getting helping hands on this project in every area of development and encourage you to have a closer look at the internals. For getting a feeling about what is currently going on, please have a look at the :ref:`changelog `. For digging deeper, we may refer you to the :ref:`development` documents. ---- Have fun! -- The Hiveeyes Developers.