An open API service indexing awesome lists of open source software.

https://github.com/Hackerfleet/hfos-legacy

Hackerfleet Operating System
https://github.com/Hackerfleet/hfos-legacy

circuits collaboration component-architecture decentralized event-driven framework microservices navigation productivity python scientific

Last synced: 3 months ago
JSON representation

Hackerfleet Operating System

Awesome Lists containing this project

README

          

.. image:: https://travis-ci.org/Hackerfleet/hfos.svg?branch=master
:target: https://travis-ci.org/Hackerfleet/hfos
:alt: Build Status

.. image:: https://landscape.io/github/Hackerfleet/hfos/master/landscape.svg?style=flat
:target: https://landscape.io/github/Hackerfleet/hfos/master
:alt: Quality

.. image:: https://coveralls.io/repos/Hackerfleet/hfos/badge.svg
:target: https://coveralls.io/r/Hackerfleet/hfos
:alt: Coverage

.. image:: https://requires.io/github/Hackerfleet/hfos/requirements.svg?branch=master
:target: https://requires.io/github/Hackerfleet/hfos/requirements/?branch=master
:alt: Requirements Status

.. image:: https://img.shields.io/badge/IRC-%23hackerfleet%20on%20freenode-blue.svg
:target: http://webchat.freenode.net/?randomnick=1&channels=hackerfleet&uio=d4>
:alt: IRC Channel

HFOS - The Hackerfleet Operating System
=======================================

**A collaborative and modular infrastructure for your data.**

* **Geo Information** Use a sophisticated map to annotate and review geographical information
* **Vehicle support** Attach a sailyacht, your camper or pack one in your backpack
* **Project planning** Issue tracking for collaborative teams
* **Modular** Expandable with integrated modules, build your own
* **Cloud independent** Run nodes on your own infrastructure

Installation
============

There is more than one way of installing HFOS, `see the quickstart instructions for those `__.

The simplest way is to use the supplied installation script:

.. code-block:: sh

sudo ./install

The installation produces a lot of output which is automatically piped into 'output.log'.
It installs all dependencies then sets up a user account and the system's services.
This assumes, that you're not running another web server on port 443 and that your firewall is
configured to allow communications on that port.
HFOS modules may require additional open ports, to find out about that, read their readme files.

If you run into trouble or get any unexpected errors, contact us or `try the complex installation procedure `__.

Modules
=======

The system is modular, so you can install what you need and leave other things.

A lot of the included modules are still Work in Progress, so help out, if you're interested
in a powerful - **cloud independent** - collaboration tool suite.

General modules
---------------

These are 'official' Hackerfleet developed modules. If you'd like to contribute your own,
ping riot@c-base.org, to get it added to the list.

============== ==============================================================
Name Description
============== ==============================================================
sails Web UI, compatible with all modern browsers
automat Automation for non programmers
alert User alerting and notification system
calc Integrated EtherCalc
camera Camera support
chat Integrated chat
comms Communication package
countables Count arbitrary things
dash Dashboard information system
enrol Enrollment (new user) management
equipment Equipment management
filemanager File management
garden Garden automation tools
ldap LDAP user authorization
library Library management
mesh Mesh networking
nodestate Node wide status system
polls Tool for lightweight internet voting
project Project management tools
protocols Miscellaneous communication protocols
robot RC remote control unit
shareables Shared resource blocking tool
switchboard Virtual switchboard
wiki Etherpad + Wiki = awesomeness
============== ==============================================================

Many of these are not yet fully usable, so please help out and perhaps take ownership of one (or more) of them!

Navigation (Hackerfleet) modules
--------------------------------

We primarily focused on navigation tools, so these are currently the 'more usable' modules.
They are far from complete, see the WiP list below.

*Obligatory Warning*: **Do not use for navigational purposes!**
*Always have up to date paper maps and know how to use them!*

============== ==============================================================
Name Description
============== ==============================================================
anchor Automatic anchor safety watcher
busrepeater Tool to repeat navigation data bus frames to other media
logbook Displaying and manual logging of important (nautical) events
maps (Offline) moving maps with shareable views/layers
navdata Navigational data module
nmea NMEA-0183 Navigation data and AIS bus parser
webguides Importer for skipperguide.de wiki content into the map
============== ==============================================================

Work in progress
----------------

- Full GDAL based vector chart support (Currently only raster charts)
- Dynamic Logbook
- GRIB data (in charts)
- Navigation aides, planning
- Datalog, automated navigational data exchange
- Crew management, more safety tools
- wireless crew network and general communications

Bugs & Discussion
=================

Please research any bugs you find via our `Github issue tracker for
HFOS `__ and report them,
if they're still unknown.

If you want to discuss distributed, opensource (or maritime) technology
in general incl. where we're heading, head over to our `Github discussion
forum `__
...which is cleverly disguised as a Github issue tracker.

You can also find us here:

* `github.com/Hackerfleet `__
* `reddit `__
* `Twitter `__
* `Facebook `__
* `soup.io `__
* `G+ `__
* `irc #hackerfleet on freenode `__

.. note:: Please be patient when using IRC, responses might take a few hours!

Contributors
============

Code
----

- Heiko 'riot' Weinen riot@c-base.org
- Johannes 'ijon' Rundfeldt ijon@c-base.org
- Martin Ling
- Sascha 'c_ascha' Behrendt c_ascha@c-base.org

Assets
------

- Fabulous icons by iconmonstr.com and Hackerfleet contributors

Support
-------

- `c-base e.V. `__ our home base, the spacestation below Berlin Mitte
- Lassulus for hosting and nix expertise
- `Jetbrains s.r.o `__ for the opensource license of their ultimate IDE
- `Github `__ for hosting our code
- `Gitlab `__ for hosting our code ;)
- `Travis.CI `__ for continuous integration services
- `BrowserStack `__ for cross device testing capabilities

License
=======

Copyright (C) 2011-2018 riot and others.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program. If not, see .

-- :boat: :+1: