Skip to main content

Discourse

RunLLM can help you maintain your Discourse community by automatically respodning to your posts. To deploy RunLLM to Discourse, follow these steps:

  1. Create a RunLLM user. Every post has to be associated with a particular user, so we recommend creating a separate user for RunLLM on your Discourse instance. Please use the RunLLM logo as the avatar for the user.
  2. Create an API key corresponding to that user. Go to the admin dashboard for your Discourse group and select API keys under advanced. Create a new API key that has access to the RunLLM user. Please save this key
  3. Create a webhook on Discourse. Go to the admin dashboard for your Discourse group and select Webhooks. Click Add webhook and enter the following fields:
    • Payload URL: https://api.runllm.com/api/discourse/webhook
    • Secret: Enter a unique string that is minimum 12 characters — note that while Discourse calls this optional, RunLLM requires a secret
    • Events: No events will be responded to other than "Post is created" — uncheck all other boxes
    • Active: This is very important — please check the active box at the very bottom, or events will not be sent!
    • (Optional) Categories and Tags: If you have specific categories or tags you'd like RunLLM to respond to, you can select them from the corresponding dropdowns.
  4. Create a deployment on RunLLM: Go to the RunLLM admin dashboard and navigate to the Config tab for your deployment. Click Add deployment and select Discourse. Enter the base URL of your Discourse instance (e.g., https://runllm.discourse.group), the API key you created in step 2, and the secret you entered in Step 3. Hit save, and you're done!