🏑 README by @agora

Welcome to the Agora!

This is an Agora. You can find a reference implementation live at https://anagora.org/ . This Agora's architecture has several components distributed over three git repositories:

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 . 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 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

To run the reference Agora:

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

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).