hivemind is an off-chain consensus layer for Steem communities and API server for social features like feeds and follows.

Make sure you have Python 3.5+, Docker and MySQL installed on your local machine.

First, we need to start a MySQL server (in Docker).

make mysql

Then we need to set DATABASE_URL environment variable, for example:

set DATABASE_URL 'mysql://root:root_password@mysql:3306/testdb'

I defined mysql in /etc/hosts such that it links to mysql docker container IP.

Lastly we invoke the ensure-schema command to create MySQL tables.

hive db ensure-schema --yes

We can index the blockchain using cli as well.

hive indexer from-steemd

If we have a .json.lst file containing first X blocks, we can index from that (its much faster).

hive indexer from-file /path/to/blocks.json.lst

hive server dev-server --port 1234

BYO MySQL deployment (ie. Amazon RDS). Hive is deployed as Docker container (see Dockerfile).

Please see /service.

Generate documentation.

cd docs
make html

Then open docs/_build in browser.

Community Spec Draft

MIT