Agora Server

• a [[project]]
  • [[agora]] [[interlay]] [[overlay]]
  • [[go]] https://github.com/flancian/agora-server
  • [[git]] https://github.com/flancian/agora-server
  • [[bugs]] https://github.com/flancian/agora-server/issues
  • [[bug]] https://github.com/flancian/agora-server/issues/new
  • [[history]] https://github.com/flancian/agora-server/commits/main
  • Works with a simple implementation of the [[Agora Protocol]]; includes a web frontend and a simple backend. If you’re reading this on anagora.org right now, you’re using it.
  • Python3 based, uses Flask. Quite simple really.
  • It currently renders a collection of [[digital garden]]s as lazily assembled into a [[distributed knowledge graph]]. The graph is plug-and-play and is hosted in a different repository; that repository is the actual [[Agora]]. For the reference repository (which, again, you’re likely viewing right now if you’re on anagora.org), see https://flancia.org/go/agora pull.
  • Copyright for this implementation as linked above is Google’s, but the license is open source (Apache). Note this is not an official Google project and won’t be supported by Google.
  • See [[Agora Version]] for per-version information.

• server backend for [[agora]]
• talks to [[agora ctzn]] RIP 🪦

Agora Server

• [[flancian]] https://social.coop/@flancian/107370596490792798 pull
• [[flancian]] https://social.coop/@flancian/107951750674969019 pull
• [[flancian]] https://social.coop/@flancian/108221522750639930 pull
• [[flancian]] https://social.coop/@flancian/108261451433523622 pull
• [[flancian]] https://social.coop/@flancian/108330123733881693 pull
• [[flancian]] https://social.coop/@flancian/109020156161609741 pull
• [[flancian]] https://social.coop/@flancian/109247460034797388 pull
• [[flancian]] https://social.coop/@flancian/109332408158900945 pull
• [[flancian@social.coop]] https://social.coop/@flancian/110437469021992141 pull

• [[flancian@social.coop]] https://social.coop/@flancian/109919401327330702 pull

• [[flancian]] https://twitter.com/flancian/status/1465952188673531909 pull
• [[flancian]] https://twitter.com/flancian/status/1469757639945240577 pull
• [[flancian]] https://twitter.com/flancian/status/1425106275663290373 pull
• [[flancian]] https://twitter.com/flancian/status/1421566367875190791 pull
• [[flancian]] https://twitter.com/flancian/status/1503146195262361605 pull
• [[flancian]] https://twitter.com/flancian/status/1515032080165609474 pull
• [[flancian]] https://twitter.com/flancian/status/1520411444768124930 pull
• [[flancian]] https://twitter.com/flancian/status/1524303408659845122 pull
• [[flancian]] https://twitter.com/flancian/status/1527360592599650308 pull
• [[zeno_dox]] https://twitter.com/zeno_dox/status/1527719193281548288 pull
• [[flancian]] https://twitter.com/flancian/status/1571524638340947976 pull
• [[2022-10-21 15:09:39+00:00]] @[[flancian]]: https://twitter.com/flancian/status/1583475611275644929 pull
• [[2022-10-28 19:03:23+00:00]] @[[flancian]]: https://twitter.com/flancian/status/1586071143701790721 pull
• [[2022-11-26 00:27:48+00:00]] @[[flancian]]: https://twitter.com/flancian/status/1596299649035685888 pull

• [[flancian]] https://twitter.com/flancian/status/1485196844548476932 pull

• [[2022-05-09 09:28:12]] [[@flancian:matrix.org]] (link):
  • done with Twitter, plan to fix a bug tonight with hashtags+punctuation; and then work on the [[agora server]] side of things
• [[2022-06-03 22:18:34]] [[@flancian:matrix.org]] (link):
  • and [[agora server]] is basically a quickly coded [[node viewer]]
• [[2022-07-09 18:12:00]] [[@flancian:matrix.org]] (link):
  • I think it also helps keep [[agora server]] easy to run and scale
• [[2022-07-09 18:19:20]] [[@flancian:matrix.org]] (link):
  • it was to make sure that we kept [[agora server]] free of write paths
• [[2023-07-28 19:08:05]] [[@flancian:matrix.org]] (link):
  • ahoy! [[agora server]] and [[agora bridge]] are both mostly python (with some typescript thrown in), but the idea behind the Agora design is that integrations should be doable relatively independently of these codebases.
• [[2023-09-07 21:24:45]] [[@flancian:matrix.org]] (link):
  • but in [[agora server]] I’ve tried to keep a ‘default handler’ approach, where each URL brings up ‘at least a node’
• [[2023-12-16 19:44:02]] [[@flancian:matrix.org]] (link):
  • I’ve been meaning to set up a sort of [[prompt router]] within [[agora server]] for a while
• [[2024-08-12 17:30:48]] [[@flancian:matrix.org]] (link):
  • [[agora server]] and [[agora bridge]] are 95% Python 😄

• [[2022-03-12 17:36:06]] [[@flancian:matrix.org]] (link):
  • oh, nice! [[agora bridge]] could do this, then [[agora server]] could just embed the html as a subnode.
• [[2022-04-10 14:00:21]] [[@flancian:matrix.org]] (link):
  • ahoy! yeah, so I went through the internal process to retain copyright on the Agora as a side project and I didn’t get it. so all code (repos [[agora server]], [[agora bridge]]) has Google copyright notices.
• [[2022-04-10 14:01:11]] [[@flancian:matrix.org]] (link):
  • IIUC it doesn’t make a difference as I don’t personally care about copyright. it only affects contributors as they need to sign a [[cla]] (one time only) to contribute to [[agora server]] or [[agora bridge]].
• [[2022-04-13 10:58:06]] [[@flancian:matrix.org]] (link):
  • by this I mean: as far as I can tell the only outcome from Google holding copyright for the Agora code ([[agora server]], [[agora bridge]]) is that 1. they choose the license, 2. they choose where the primary repos are to be hosted, 3. they require me to check for a signed [[cla]] before accepting contributions.
• [[2022-04-15 11:38:26]] [[@flancian:matrix.org]] (link):
  • thank you! yes, I agree with this. if the Agora is valuable I think having different implementations, hopefully all capable of talking a common Agora protocol to each other, would be desirable. and the base implementation of an [[agora server]] is simple, given the file-based nature of it — it took me one weekend to code a barebones version and get it serving, and I’m no great coder.
• [[2022-05-07 17:44:56]] [[@flancian:matrix.org]] (link):
  • you could imagine [[agora server]] rendering markdown -> html, and then saving html to sqlite in case it’s useful to any readers

• [[2022-10-21 15:09:39+00:00]] @[[flancian]]: https://twitter.com/flancian/status/1583475611275644929 pull

Over tcp it serves HTTP: a web interface, [[agora server]].

Port [[5018]] is also optimistically claimed to serve an API, [[agora bridge]].

• [[2022-10-28 19:03:23+00:00]] @[[flancian]]: https://twitter.com/flancian/status/1586071143701790721 pull

Ha, [[agora server]] has a memory leak you could say :)

But this is just me being sloppy; the leak affects the dev environment I run in the same server (different user). I need to move that elsewhere as it doesn’t make sense to cause mini-outages for silly reasons. https://t.co/FjGQLudGoJ

• [[2022-11-26 00:27:48+00:00]] @[[flancian]]: https://twitter.com/flancian/status/1596299649035685888 pull

The next step is to make /prime/51 execute https://t.co/fe7VSlVeI8 51 in this case. But scripts that don’t take any parameters already work here. They execute in the same virtual environment [[agora server]] runs in currently, in an async thread (not the one rendering the (1/2)