Welcome to the Agora!

This is an Agora. You can find a reference implementation live at https://anagora.org/ pull.

This Agora's architecture has several components distributed over three git repositories:

• The Agora root repository, which you are browsing: https://github.com/flancian/agora.
  • This root repository contains a high level definition of the Agora as expressed by the list of digital gardens to be integrated (sources.yaml) and the contract agreed upon by the community (CONTRACT.md).
• The Agora Server: https://github.com/flancian/agora-server.
  • Which contains a reference Python / Flask web app that integrates and serves content. It is live at https://anagora.org pull.
• The Agora Bridge: https://github.com/flancian/agora-bridge.
  • Which contains a set of processes to retrieve content as volunteered by users.

Wait, what's an Agora again?

An Agora is a distributed, goal-oriented social network operating on a cooperatively built and maintained knowledge graph. The implementation you are currently looking at tries to assemble such a graph out of a collection of digital gardens, but other data sources are coming.

You can view the Agora at https://anagora.org pull. For how to write to it: if you take personal digital notes with some system such as foam or obsidian, you are most of the way there; all you need to do is share them with the Agora (see "join" above). If you don't, but you would like to, please refer to agora client or reach out!

To join

If you would like to join the reference Agora described in this particular repository, please send a PR adding your garden to sources.yaml or reach out to flancian or a member of Flancia Collective with a pointer to your repository (or just your writing) and your choice of username.

After being integrated, your repository will appear live at https://anagora.org/@username pull and supported notes and other resources will be surfaced in the Agora in relevant nodes; this means that if you volunteer a note named foo.md, it will show up in node https://anagora.org/foo pull together with all similarly named notes by other Agora users.

To run

To run the reference Agora:

• Clone all three repositories described above (ideally in the $HOME directory of a dedicated user; this is not strictly needed, but scripts might assume this).
• Install Python requirements in each of agora-server and agora-bridge:

python3 -m venv venv
. venv/bin/activate
pip3 install -r requirements.txt

• In agora-bridge: run ./run-dev.sh to start updating repositories defined in sources.yaml.
• In agora-server: run ./run-dev.sh to start the dev web interface; or refer to https://www.digitalocean.com/community/tutorials/how-to-serve-flask-applications-with-uswgi-and-nginx-on-ubuntu-18-04 for instructions on how to set up the Agora as a system service on top of uwsgi (see prod.ini) and nginx.

Of course you are also free to run your own Agora! To do this, just run the bridge against a local sources.yaml file -- or fork the root repository and adjust as wished. As usual please reach out if you need a hand with anything :)

Contract

If you contribute directly to an Agora you are assumed to be in agreement with its then current contract.

Please refer to the Agora's contract, in particular as posted by the system account @agora (which is binding for all users).