Skip to content
Decentralised gossip driven data sharing for the 21st century.
Python JavaScript HTML Protocol Buffer CSS Makefile Other
Find file
Pull request Compare This branch is 10 commits ahead, 182 commits behind master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


groundstation is a decentralised task/project management suite.

The core of its implementation is an object store of linked immutable objects that are synced via a gossip protocol.

The current version uses libgit2 as a storage backend, but doesn't use many git primitives, beyond git's objects as a storage medium. This may change in the future.


groundstation uses pygit2 under the hood for its git interactions, and some features that it depends on have not landed in a stable release yet.

For this reason, you'll need to build and install the latest libgit2 from source.

protocol support

groundstation hinges on the notion of protocols internally- groundstation core provides you with content addressable storage, but it's up to you to work out what to actually do with that data.

That said, groundstation does ship with some protocol adaptors. Adaptors take the form name@domain:adaptor-version, and until such time as a release is already, everything that ships with groundstation will be released with as the email.


groundstation uses babashka for managing its dependencies. If you have it installed, you should be able to do something like:

babashka groundstation_dev and wind up with a working environment. Maybe.

  1. install development libgit2 (on OSX this is streamlined by brew install --HEAD libgit2)
  2. pip install -r requirements.txt
  3. ???????
  4. profit!

If not, you need:

  1. libgit2 from source. (OSX brew install --HEAD libgit2)
  2. groundstations's requirements, (pip install -r requirements).

You probably want to install those requirements in a virtualenv.

You'll almost certainly want to have a read of the hacking document, and checkout the other misc hacking docs.

Something went wrong with that request. Please try again.