index.community/README.md

1.8 KiB

fediverse.space 🌐

The map of the fediverse that you always wanted.

Read the latest updates on Mastodon: @fediversespace

A screenshot of fediverse.space

  1. Requirements
  2. Running it
  3. Commands
  4. Privacy
  5. Acknowledgements

Requirements

Though dockerized, backend development is easiest if you have the following installed.

  • For the scraper + API:
    • Elixir
    • Postgres
  • For laying out the graph:
    • Java
  • For the frontend:
    • Node.js
    • Yarn

Running it

Backend

  • cp example.env .env and modify environment variables as required
  • docker-compose build
  • docker-compose up -d phoenix
    • if you don't specify phoenix, it'll also start gephi which should only be run as a regular one-off job

Frontend

  • cd frontend && yarn install
  • yarn start

Commands

Backend

./gradlew shadowJar compiles the graph layout program. java -Xmx1g -jar build/libs/graphBuilder.jar runs it. If running in docker, this means you run

  • docker-compose build gephi
  • docker-compose run gephi java -Xmx1g -jar build/libs/graphBuilder.jar lays out the graph

Frontend

  • yarn build creates an optimized build for deployment

Privacy

This project doesn't crawl personal instances: the goal is to understand communities, not individuals. The threshold for what makes an instance "personal" is defined in the backend config and the graph builder SQL.

Acknowledgements

NLnet logo

Many thanks to NLnet for their support and guidance of this project.