https://github.com/venkytv/botmand
Inetd for Slack Bots
https://github.com/venkytv/botmand
bot chat chatbots chatgpt chatgpt-bot chatops chatops-ai slack-bot
Last synced: 5 months ago
JSON representation
Inetd for Slack Bots
- Host: GitHub
- URL: https://github.com/venkytv/botmand
- Owner: venkytv
- License: gpl-3.0
- Created: 2023-04-25T21:07:33.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-04-14T18:00:47.000Z (about 2 years ago)
- Last Synced: 2025-09-01T13:04:57.479Z (10 months ago)
- Topics: bot, chat, chatbots, chatgpt, chatgpt-bot, chatops, chatops-ai, slack-bot
- Language: Go
- Homepage:
- Size: 185 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
README
# BotManD
BotManD is a bot engine designed to simplify the process of creating Slack
bots.
BotManD is to Slack conversations what a webserver is to CGI scripts. It allows
you to write bots that are simple executables which read from stdin and write
to stdout. BotManD manages the lifecycles of the bots--launching instances on
demand (a separate instance for each conversation), and terminating
conversations when the bot executables exit.
The bots themselves can be very simple. You can write them in any language you want.
This is the complete code for a working bot which keeps track of when was the
last time someone mentioned "ChatGPT" in the channel:
```bash
#!/bin/bash
LAST_MENTION=
while :; do
read MSG
if [[ "$MSG" = *ChatGPT* ]]; then
NOW=$( date +'%s' )
if [[ -n "$LAST_MENTION" ]]; then
echo "It has been $(( NOW - LAST_MENTION )) seconds since someone mentioned ChatGPT last!"
fi
LAST_MENTION="$NOW"
fi
sleep 0.1
done
```
https://github.com/venkytv/botmand/assets/718613/92c1ea65-9cbd-46a3-b28b-be2a326f0549
See [examples](examples) for more examples. Writing a BotManD bot is so simple
that you can write a [simple bot that uses ChatGPT to write bots of its
own](examples/genbot).
### AI-powered Chatbots
BotManD is designed primarily for supporting conversational bots, which
incidentally happens to be how most current AI chatbots are set up. For
examples of how you can use BotManD to develop AI-powered chatbots, have a look
at the [gptbot](examples/gptbot), [logparse](examples/logparse), and
[genbot](examples/genbot) examples.
https://github.com/venkytv/botmand/assets/718613/acc6a5d6-1c6a-4c37-99a2-97a5e149ac6a
## Installation
* Download the [latest release](../../releases/latest) of botmand for your platform.
* Extract the archive and move the `botmand` executable to a directory of your choice.
## Quickstart
### Generate a Slack classic app bot token
1. Create a Classic Slack app: https://api.slack.com/apps?new_classic_app=1
2. Click on "App Home" in the left sidebar to get to the bot creation page.
3. Click on the "Add Legacy Bot User" button.
4. Set a display name and user name for the bot and add the bot.
5. Click on "Install App" in the left sidebar.
6. Click "Install to Workspace" and allow the bot access to the workspace.
7. At this point, you should see the "OAuth Tokens" for your workspace.
There are two tokens displayed, but you just need the "Bot User OAuth Token" which
should start with the string `xoxb-`.
8. Copy this token to the file `.slack.token` in your home directory.
### Set up the example basicbot
```bash
git clone https://github.com/venkytv/botmand.git
cd botmand/examples/basicbot
make install
```
### Invite the Slack bot to a channel in your workspace
Go to a channel in Slack and either use the `/invite` command, or just message
the new Slack bot to invite it to the channel.
### Start botmand
Launch `botmand` from the directory you moved it to.
```bash
./botmand
```
### Start a conversation
Send a "hello" message mentioning the bot name. The bot should respond in a
thread echoing what you said. And then continue echoing whatever you say in the
thread until you say "bye".
### Explore more real-world bots
* [gptbot](examples/gptbot): An AI chat assistant which can participate in the
conversation when asked to.
* [logparse](examples/logparse): An AI assistant which can diagnose issues by
reading log files.
* [genbot](examples/genbot): An AI assistant which can generate shell scripts
for requested tasks and run them within the bot.
### Write your own bot
The [bot writing guide](BOT-WRITING-GUIDE.md) has details on writing bots. You
could also have a look at the included [example bots](examples).
## Building from Source
```bash
go build
```