← all repositories
fossasia/susi_gitterbot

A chatbot bridge for Gitter rooms, circa 2017

Deploy SUSI AI into any Gitter lobby with Heroku and a personal access token.

1.5k stars JavaScript Chat AssistantsAgents
susi_gitterbot
Velocity · 7d
+0.4
★ / day
Trend
steady
star history

What it does This is a thin Node.js adapter that wires the SUSI AI chat backend into a Gitter room via Gitter’s streaming API. You fork it, hook it to Heroku, paste in a room ID and token, and get an @-mentionable bot that answers queries like currency conversion.

The interesting bit The whole thing is essentially glue between two APIs—Gitter’s streaming endpoint and SUSI’s query endpoint—yet the README treats this as a nine-step onboarding ritual complete with screenshots of every Heroku button. There’s something almost archaeological about the thoroughness; it documents a specific era of “fork, deploy to Heroku, hope” bot deployment.

Key highlights

  • Uses Gitter’s streaming API for real-time message ingestion
  • Responds only when @-mentioned (@susiai)
  • Deploy-ready for Heroku with environment-based config (ROOM_ID, TOKEN)
  • Docker Cloud deploy button also provided
  • Live demo bot exists in a public Gitter lobby for testing

Caveats

  • README assumes Gitter’s developer flow and Heroku’s UI from ~2017; several screenshots and steps may now be stale
  • No code or architecture discussion in the README—just deployment steps
  • SUSI AI itself is not explained; you are trusting an external API

Verdict Grab this if you need a quick, historical reference for Gitter bot plumbing or still maintain a SUSI AI integration. Skip it if you want modern chatbot frameworks, active maintenance, or any visibility into what the code actually does.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.