This bot collects human feedback to create a dataset for RLHF-alignment of an assistant chat bot based on a large language model. You and other people can teach the bot how to respond to user requests by demonstration and by ranking the bot's outputs. If you want to learn more about RLHF please refer to OpenAI's InstructGPT blog post.

Invite official bot

To add the official Open-Assistant data collection bot to your discord server click here. The bot needs access to read the contents of user text messages.

Contributing

If you are unfamiliar with hikari, lightbulb, or miru, please refer to the large list of examples

Bot Setup

Create a new discord application at the Discord Developer Portal
Go to the "Bot" tab and create a new bot
Scroll down to "Privileged Gateway Intents" and enable the following options:
- Server Members Intent
- Presence Intent
- Message Content Intent

This page also contains the bot token, which you will need to add to the .env file later.

Go to the "OAuth2" tab scroll to "Default Authorization Link"
Set "AUTHORIZATION METHOD" to "In-app Authorization"
Select the "bot" and "applications.commands" scopes
For testing and local development, it's easiest to set "BOT PERMISSIONS" to "Administrator"

Remember to save your changes.

Copy the "CLIENT ID" from the top of the page and replace it in the link below to invite your bot.

https://discord.com/oauth2/authorize?client_id=YOUR_CLIENT_ID_HERE&permissions=8&scope=bot%20applications.commands

Discord setup for development

Create DISCORD_CLIENT_ID and DISCORD_CLIENT_SECRET keys in the .env file in website.
Go to https://discord.com/developers/applications and click on New Application and create a new application.
Once the new application is created, you will have access to Client ID and Client Secret in the OAuth2 section. Copy those values and paste for the respective fields in the .env file.
In the Oauth2 section, there is an field called Redirects which has to be provided with the following URL. This URL is nothing but the discord callback URL which NextAuth uses - http://localhost:3000/api/auth/callback/discord (The PORT number for the localhost could be different based on your setup)

Environment Setup

To run the bot:

Install dependency module oasst-shared

cd oasst-shared
pip install -e .

cp .env.example .env

# edit .env and add your bot token and other values
# BOT_TOKEN is given by the discord developer portal when you create a bot
# DECLARE_GLOBAL_COMMANDS is the id of the server where you added the bot (right click on the server icon and copy id)
# OWNER_ID can be leave as an empty list

python -V  # 3.10

pip install -r requirements.txt

# in the discord-bot folder
python -m bot

Before you push, make sure the pre-commit hooks are installed and run successfully.

pip install pre-commit
pre-commit install

...

git add .
git commit -m "<good commit message>"
# if the pre-commit fails
git add .
git commit -m "<good commit message>"

Resources

Structure

Important files

.env                        # Environment variables
.env.example                # Example environment variables
CONTRIBUTING.md             # This file
README.md                   # Project readme
EXAMPLES.md                 # Examples for commands and listeners
requirements.txt            # Requirements

bot/
├─  __main__.py             # Entrypoint
├─  api_client.py           # API Client for interacting with the backend
├─  bot.py                  # Main bot class
├─  settings.py             # Settings and secrets
├─  utils.py                # Utility Functions
│
├─  db/                     # Database related code
│   ├─  database.db         # SQLite database
│   ├─  schema.sql          # SQL schema
│   └─  schemas.py          # Python table schemas
│
└── extensions/             # Application logic, see https://hikari-lightbulb.readthedocs.io/en/latest/guides/extensions.html
    ├─  work.py             # Task handling logic  <-- most important file
    ├─  guild_settings.py   # Server specific settings
    └─  hot_reload.py       # Utility for hot reload extensions during development

Adding a new command/listener

Create a new file in the extensions folder
Copy the template below

# -*- coding: utf-8 -*-
"""My plugin."""
import lightbulb

plugin = lightbulb.Plugin("MyPlugin")

# Add your commands here

def load(bot: lightbulb.BotApp):
    """Add the plugin to the bot."""
    bot.add_plugin(plugin)


def unload(bot: lightbulb.BotApp):
    """Remove the plugin to the bot."""
    bot.remove_plugin(plugin)

Docs

Discord

Discord API Reference

hikari (main framework)

lightbulb (command handler)

miru (component handler: buttons, modals, etc... )

Miru Repo