openSUSE Kudos Bots 🤖💚

This repository provides simple chat integration bots for the
openSUSE Kudos platform.

The bots listen to the live Kudos event stream and post updates to chat platforms.

Currently supported:

• 💬 Matrix
• 💬 Slack

---

✨ What it does

The bots connect to the Kudos live event stream and announce:

• 💚 New kudos events
• 🏅 Badge achievements

Example message:

💚 Alice just earned kudos for packaging from Bob
> Thanks for fixing the build!

🔗 https://kudos.opensuse.org/...
🎉 Congrats! 👏

---

🚀 Quick start (development)

Requirements

• Node.js ≥ 20
• npm

Install dependencies

npm install

---

Matrix bot

Create .env.matrix:

MATRIX_HOMESERVER=https://matrix.opensuse.org
MATRIX_ACCESS_TOKEN=...
MATRIX_ROOM_ID=!roomid:opensuse.org
STREAM_URL=https://kudos.opensuse.org/api/now/stream

Run:

node kudos-matrix-bot.js

---

Slack bot

Create .env.slack:

SLACK_BOT_TOKEN=...
SLACK_CHANNEL=#your-channel
STREAM_URL=https://kudos.opensuse.org/api/now/stream

Run:

node kudos-slack-bot.js

---

📦 Packaging (openSUSE)

This project is packaged as kudos-bots.

Installed layout:

/usr/lib/kudos-bots/        # application files
/etc/kudos-bots/            # configuration
/var/lib/kudos-bots/        # runtime data

Systemd services:

• kudos-bots-matrix.service
• kudos-bots-slack.service

Enable a bot:

sudo systemctl enable --now kudos-bots-matrix

---

⚙️ Configuration

Configuration is provided via environment files:

/etc/kudos-bots/kudos-bots-matrix.env
/etc/kudos-bots/kudos-bots-slack.env

Values are not overwritten on package upgrades.

---

🛑 Notes

• Bots run on kudos@kudos-prod.infra.opensuse.org
• Bots send a startup greeting when connected
• Bots send a goodbye message on graceful shutdown
• kill -9 or crashes will not trigger a shutdown message

---

📜 License

Apache-2.0

---

💚 About openSUSE Kudos

openSUSE Kudos is a recognition platform for the openSUSE community:

👉 https://kudos.opensuse.org

It allows contributors to give kudos and earn badges for their work.