This Agora's architecture has several components distributed over three git repositories:
sources.yaml) and the contract agreed upon by the community (
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 . 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!
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 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 together with all similarly named notes by other Agora users.
To run the reference Agora:
python3 -m venv venv . venv/bin/activate pip3 install -r requirements.txt
./run-dev.shto start updating repositories defined in
./run-dev.shto 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 :)
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).