A modern, opensource approach to maritime navigation.
This software package is supposed to run on your ship/car/plane/ufo's board computer.
Obligatory Warning: Do not use for navigational purposes!
Always have up to date paper maps and know how to use them!
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 (opensource) 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.
Before doing anything with HFOS, be sure you have all the dependencies installed via your distribution's package manager. For Debian Unstable use this:
sudo apt-get install mongodb python3.4 python3-pip python3-grib \
python3-bson python3-pymongo python3-serial
If you want (and can), install the mongo and bson extensions:
sudo apt-get install python3-pymongo-ext python3-bson-ext
Setup the source folder and virtual environment for Python 3.4:
cd ~/src
git clone https://github.com/hackerfleet/hfos
cd hfos
virtualenv -p /usr/bin/python3.4 --system-site-packages
Activate venv and run setup.py:
source venv/bin/activate
python setup.py develop
Run hfos:
python scripts/hfos
You should see some info/debug output and the web engine as well as other components starting up. Currently it is set up to serve only on http://localhost:8055 - so point your browser there and explore HFOS.
Outdated - these do not work without some additional work Debian instructions:
If you're using Debian, we provide a skeleton to build a cleanly installable dpkg package:
sudo apt-get install dpkg-dev
dpkg-buildpackage
Run buildpackage in the top source directory to generate a debian package.
Lives in /etc/hfos/config.json
after installation, but is currently not used.
We like to hang out on irc, if you want to chat or help out, join irc://freenode.org/hackerfleet :)
A boatload of other libraries like Bootstrap or Leaflet are currently hosted in this repo, this will change when we're done splitting up client and node.
Missing? Add yourself or ping us ;)
:boat: :+1: