From 80c3a311b0c68cfc5fb3b38a9e88a086fdcdc2e9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tao=20Bror=20Bojl=C3=A9n?= Date: Wed, 20 Feb 2019 16:49:45 +0000 Subject: [PATCH] update README --- README.md | 37 +++++++++++++++++++++++++++++-------- 1 file changed, 29 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 6e24e78..3ab4ef3 100644 --- a/README.md +++ b/README.md @@ -1,12 +1,33 @@ # fediverse.space -fediverse.space is a tool to explore instances in the fediverse. +fediverse.space is a tool to explore instances in the fediverse 🌐 + +## Requirements +- For everything: + - Docker + - Docker-compose +- For the scraper + API: + - Python 3 +- For laying out the graph: + - Java +- For the frontend: + - Yarn ## Running it -* `cp config.json.template config.json` and enter your configuration details. I've used a postgres database for development. -* Set the environment variable `FEDIVERSE_CONFIG` to point to the path of this file. -* `pip install -r requirements.txt` -* `yarn install` -* Make sure you have the Java 8 JRE (to run) or JDK (to develop) installed, and gradle -* For development, run `python manage.py runserver --settings=backend.settings.dev` -* In production, set the environment variable `DJANGO_SETTINGS_MODULE=backend.settings.production` +### Backend +- `cp example.env .env` and modify environment variables as required +- `docker-compose build` +- `docker-compose up -d` +### Frontend +- `cd frontend && yarn install` +- `yarn start` + +## Commands +### Backend +- `python manage.py scrape` scrapes the entire fediverse +- `python manage.py build_graph` uses this information to lay out a graph + +To run in production, use `docker-compose -f docker-compose.yml -f docker-compose.production.yml` instead of just `docker-compose`. + +### Frontend +- `yarn build` to create an optimized build for deployment