Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/flancian/garden/llms.txt

Use this file to discover all available pages before exploring further.

The Agora Bot is a component of agora-bridge that gives the Agora a presence on social networks. When someone mentions the Agora account and includes wikilinks in their message, the bot replies with direct links to those nodes on the Agora. It also follows back anyone who follows it and stores links to relevant messages in the Agora graph. Each supported platform has its own bot implementation inside the bots/ directory of the agora-bridge repository.

​
What the bots do

All Agora bots share a common set of behaviours:
  • Reply to @mentions — when a message @-mentioning the bot contains [[wikilinks]], the bot replies with links to the corresponding Agora nodes at anagora.org
  • Follow back — the bot automatically follows any account that follows it
  • Start threads — on Matrix, the bot starts threads in reply to messages in opted-in rooms
  • Store links — links to messages are stored in the Agora for future reference
Storing full message content (not just links) is a planned feature that will require explicit user consent. The current implementation only stores links.

​
Platform integrations

The Mastodon bot runs as @agora@botsin.space on the Fediverse.To interact with the bot:
  1. Follow @agora@botsin.space from any Mastodon or Fediverse account — the bot will follow you back automatically.
  2. In any toot, mention @agora@botsin.space and include one or more [[wikilinks]].
  3. The bot will reply with links to the matching Agora nodes.
Example toot:
@agora@botsin.space I've been thinking about [[solarpunk]] and [[commons]] today.
The bot replies with direct links to anagora.org/solarpunk and anagora.org/commons.The bot source lives in bots/mastodon/ inside the agora-bridge repository.

​
Deploying bots with Coop Cloud

If you prefer a managed deployment approach, there is a Coop Cloud recipe for the Agora. Coop Cloud uses abra to deploy and manage app stacks. 
# Deploy using abra (Coop Cloud CLI)
abra app deploy -C link.agor.ai
Useful troubleshooting commands: 
abra app logs link.agor.ai
abra app errors --watch link.agor.ai
abra app ps -w link.agor.ai
If containers are not starting at all, log into the host and inspect the Docker stack directly: 
docker stack ps link_agor_ai --no-trunc
A useful debugging technique is to temporarily override the container entrypoint in your Docker Compose file to keep the container alive for inspection:
entrypoint: ['tail', '-f', '/dev/null']

​
Adding bot support to your own Agora

The bots in agora-bridge are optional. To enable them when self-hosting:
1

Navigate to the bots directory

cd agora-bridge/bots
Each platform has its own subdirectory (mastodon/, twitter/). The Matrix bot is in its own repository.
2

Configure credentials

Each bot needs API credentials for its platform. Refer to the README inside each bot directory and the agora-bridge install guide for the specific environment variables and config files required.
3

Run the bot

Bots can be run directly or as systemd services alongside the main bridge process. See the service file examples in the repository.

​
Related guides

Self-host your Agora

Full installation guide covering all three Agora repositories, nginx, and UWSGI setup.

Configure Agora Bridge

Set up bridges.yaml, configure sources, and manage per-user agora.yaml files.

Build docs developers (and LLMs) love

Get started for freeTalk to us