asyncwebio/bigbluebutton-chatgpt

Use ChatGPT to improve your BigBlueButton online classes

ChatGPT for BigBlueButton

Use ChatGPT to improve your BigBlueButton online classes

ChatGPT App for BigBlueButton

OpenAI ChatGPT is an AI chatbot auto-generative system created by Open AI for online customer care. It is a pre-trained generative chat, which makes use of (NLP) Natural Language Processing.

BigBlueButton is the most-popular open-source software to conduct online classes. It is being used across thousands to schools and integrates well with Moodle, Canvas, Druple and even with your custom LMS via REST APIs. It provides everything you need for your online classes: HD audio/video conference, whiteboard, chat, presentation, polling, analytics and scales easily to conduct hundreds of classes.

ℹ️ How It works

ChatGPT is a large language model trained by OpenAI that is capable of generating human-like text. By providing it with a prompt, it can generate responses that continue the conversation or expand on the given prompt.

We have integrated ChatGPT with BigBlueButton, the most popular open-source virtual classroom software. This gives teachers (and students) the ability to unleash the power of ChatGPT to make online classes better.

After installing BigBlueButton-ChatGPT app, you can invoke ChatGPT by sending @chatgpt <prompt> message in the Public Chat. The app would make a call to the ChatGPT API, passing the prompt, get and publish the response.

✨ Features

You can get started by sending @chatgpt help in Public Chat of BigBlueButton that would show the following prompts.

• Create a quiz with 5 multiple choice questions that assess students’ understanding of [concept being taught].
• Find the bug with this code:
• What exactly does this regex do? rege(x(es)?|xps?).
• Describe in detail.
• Please provide a definition for the medical term ‘tachycardia’.

For more prompts, please refer to this document.

🖐 Requirements

• A server with BigBlueButton 2.5+ installed
• Docker with Docker compose

⏳ Instllation

It hardly takes few minues to install ChatGPT app for BigBlueButton, as detailed below:

git clone https://github.com/AsyncWeb/bigbluebutton-chatgpt.git

cd bigbluebutton-chatgpt

#update the CHAT_GPT_API_TOKEN in .env
cp sample-env .env

# start the application
sudo docker-compose up -d

🔧 Configuration

You would need to create an account on OpenAI to get chatGPT token by visiting this page on OpenAI Update .env file in the project root directory, look for CHAT_GPT_API_TOKEN environment and set it to the token that you have got.

You can enable chatGPT for all attendees of BigBlueButton or restrict it to only moderators, which is recommended in an online classroom setting. To enable chatGPT, set CHAT_GPT_ENABLED as true or false otherwise; By default, chatGPT is enabled only for moderators. To enable chatGPT for all attendees, set CHAT_GPT_ENABLE_FOR_VIEWER as true or false otherwise;

In addition, there are few more environment variables set, which works out-of-the-box for default BigBlueButton installation.

💡 How to use it

• Start a bbb meeting and join as moderator
• Enter @chatGPT help in public chat to see example prompts
• Use one of the example prompts to get started

🚮 Uninstall

• Stop the docker container

cd bigbluebutton-chatgpt

docker-compose down

• Remove the docker image

docker rmi <bigbluebutton-chatgpt image name>

# example
docker rmi bigbluebutton-chatgpt_bbb-chatgpt

🚀 Stress-free BigBlueButton hosting! Start free Trial

Save big with our affordable BigBlueButton hosting.

• Bare metal servers for HD video
• 40% lower hosting costs
• Top-rated tech support, 100% uptime
• Upgrade / cancel anytime
• 2 weeks free trial; No credit card needed

Start Free Trial

bigbluebutton-chatgpt's Issues

Does not work. nvm version error

Hi, I have a standalone installation of BBB version 2.6RC5 and followed the instructions to install chatGPT but it does not work. I got a npm version not updated message on installation when following the sudo docker-compose up -d

MongoDB connection issue / timeout

Hi everyone,

I'am getting this problem below and have no clue how to proceed / debug. Could you give a pointer please?
Using BBB 2.5.9.

Recreating bbb-chatgpt ... done
Attaching to bbb-chatgpt
bbb-chatgpt    | 
bbb-chatgpt    | > [email protected] start
bbb-chatgpt    | > node app.js
bbb-chatgpt    | 
bbb-chatgpt    | Client Connected to Redis
bbb-chatgpt    | Publisher Connected to Redis
bbb-chatgpt    | MongoServerSelectionError: connection <monitor> to 127.0.0.1:4101 closed
bbb-chatgpt    |     at Timeout._onTimeout (/usr/src/app/node_modules/mongodb/lib/sdam/topology.js:284:38)
bbb-chatgpt    |     at listOnTimeout (node:internal/timers:568:17)
bbb-chatgpt    |     at process.processTimers (node:internal/timers:511:7)

Best regards!

How can I change the help text and example prompts in another language for example in german

I can find the "@chatgpt help" texts and example prompts in file app.js. And I have changed them to german. Then i do docker-compose down and docker-compose up -d. When i type in the public chat of bigbluebutton "@chatgpt help" all texts are is still in english. Please give a tip for changing the texts.

error command sh -c node app.js

Hi everyone,

you might already have missed me, so I thought maybe a can create another issue ;-) .

Joking aside, after launching docker-compose up -d the docker logs show me the stack traces below.
Seems like an installation issue with npm to me.

Any pointers how to proceed with this?

0 verbose cli /usr/local/bin/node /usr/local/bin/npm
1 info using [email protected]
2 info using [email protected]
3 timing npm:load:whichnode Completed in 1ms
4 timing config:load:defaults Completed in 1ms
5 timing config:load:file:/usr/local/lib/node_modules/npm/npmrc Completed in 0ms
6 timing config:load:builtin Completed in 2ms
7 timing config:load:cli Completed in 1ms
8 timing config:load:env Completed in 0ms
9 timing config:load:file:/usr/src/app/.npmrc Completed in 0ms
10 timing config:load:project Completed in 1ms
11 timing config:load:file:/root/.npmrc Completed in 0ms
12 timing config:load:user Completed in 1ms
13 timing config:load:file:/usr/local/etc/npmrc Completed in 0ms
14 timing config:load:global Completed in 0ms
15 timing config:load:setEnvs Completed in 1ms
16 timing config:load Completed in 8ms
17 timing npm:load:configload Completed in 9ms
18 timing npm:load:mkdirpcache Completed in 2ms
19 timing npm:load:mkdirplogs Completed in 0ms
20 verbose title npm start
21 verbose argv "start"
22 timing npm:load:setTitle Completed in 1ms
23 timing config:load:flatten Completed in 2ms
24 timing npm:load:display Completed in 2ms
25 verbose logfile logs-max:10 dir:/root/.npm/_logs/2023-03-02T10_46_56_241Z-
26 verbose logfile /root/.npm/_logs/2023-03-02T10_46_56_241Z-debug-0.log
27 timing npm:load:logFile Completed in 3ms
28 timing npm:load:timers Completed in 0ms
29 timing npm:load:configScope Completed in 0ms
30 timing npm:load Completed in 18ms
31 silly logfile done cleaning log files
32 http fetch GET 200 https://registry.npmjs.org/npm 197ms (cache updated)
33 http fetch GET 200 https://registry.npmjs.org/npm 214ms (cache updated)
34 timing command:run-script Completed in 304685ms
35 timing command:start Completed in 304698ms
36 notice
36 notice New minor version of npm available! 9.4.0 -> 9.6.0
36 notice Changelog: <https://github.com/npm/cli/releases/tag/v9.6.0>
36 notice Run `npm install -g [email protected]` to update!
36 notice
37 verbose stack Error: command failed
37 verbose stack     at ChildProcess.<anonymous> (/usr/local/lib/node_modules/npm/node_modules/@npmcli/promise-spawn/lib/index.js:53:27)
37 verbose stack     at ChildProcess.emit (node:events:512:28)
37 verbose stack     at maybeClose (node:internal/child_process:1098:16)
37 verbose stack     at ChildProcess._handle.onexit (node:internal/child_process:304:5)
38 verbose pkgid [email protected]
39 verbose cwd /usr/src/app
40 verbose Linux 5.4.0-135-generic
41 verbose node v19.6.1
42 verbose npm  v9.4.0
43 error path /usr/src/app
44 error command failed
45 error signal SIGTERM
46 error command sh -c node app.js
47 verbose exit 1
48 timing npm Completed in 304748ms
49 verbose code 1
50 error A complete log of this run can be found in:
50 error     /root/.npm/_logs/2023-03-02T10_46_56_241Z-debug-0.log

Is it compatible with version 2.7.0?

Tried to make it work on 2.7.0 but not responding