matrix_chatgpt_bot/README.md

116 lines
2.8 KiB
Markdown
Raw Permalink Normal View History

2023-03-05 14:07:25 +00:00
## Introduction
2023-04-11 03:11:59 +00:00
2023-04-13 15:49:12 +00:00
This is a simple Matrix bot that uses OpenAI's GPT API and Bing AI to generate responses to user inputs. The bot responds to five types of prompts: `!gpt`, `!chat` and `!bing` and `!pic` and `!bard` depending on the first word of the prompt.
![Bing](https://user-images.githubusercontent.com/32976627/231073146-3e380217-a6a2-413d-9203-ab36965b909d.png)
![Bard](https://i.imgur.com/OCXEuaa.png)
![ChatGPT](https://i.imgur.com/kK4rnPf.jpeg)
## Feature
2023-04-11 03:11:59 +00:00
2023-04-13 15:49:12 +00:00
1. Support Openai ChatGPT and Bing AI and Google Bard(US only at the moment)
2. Support Bing Image Creator
3. Support E2E Encrypted Room
2023-04-11 06:21:36 +00:00
4. Colorful code blocks
2023-04-07 01:28:47 +00:00
2023-03-05 14:07:25 +00:00
## Installation and Setup
2023-04-11 03:11:59 +00:00
2023-04-10 02:52:18 +00:00
Docker method(Recommended):<br>
Edit `config.json` or `.env` with proper values <br>
2023-03-10 16:47:04 +00:00
Create an empty file, for persist database only<br>
2023-04-11 03:11:59 +00:00
2023-03-09 15:45:25 +00:00
```bash
2023-04-10 02:52:18 +00:00
touch db
2023-03-09 15:45:25 +00:00
sudo docker compose up -d
```
2023-04-11 03:11:59 +00:00
2023-03-09 15:45:25 +00:00
<hr>
2023-04-11 03:11:59 +00:00
Normal Method:<br>
2023-03-09 15:45:25 +00:00
1. Clone the repository and create virtual environment:
2023-04-11 03:11:59 +00:00
2023-03-05 14:07:25 +00:00
```
git clone https://github.com/hibobmaster/matrix_chatgpt_bot.git
python -m venv venv
source venv/bin/activate
2023-03-05 14:07:25 +00:00
```
2023-04-11 03:11:59 +00:00
2023-03-05 14:07:25 +00:00
2. Install the required dependencies:<br>
2023-04-11 03:11:59 +00:00
2023-03-05 14:07:25 +00:00
```
2023-04-11 03:11:59 +00:00
pip install -U pip setuptools wheel
2023-03-05 14:07:25 +00:00
pip install -r requirements.txt
```
2023-04-11 03:11:59 +00:00
2023-03-05 14:07:25 +00:00
3. Create a new config.json file and fill it with the necessary information:<br>
2023-04-11 03:11:59 +00:00
Use password to login(recommended) or provide `access_token` <br>
If not set:<br>
`room_id`: bot will work in the room where it is in <br>
`api_key`: `!chat` command will not work <br>
`bing_api_endpoint`: `!bing` command will not work <br>
`bing_auth_cookie`: `!pic` command will not work
2023-03-05 14:07:25 +00:00
```json
{
2023-04-11 03:11:59 +00:00
"homeserver": "YOUR_HOMESERVER",
"user_id": "YOUR_USER_ID",
"password": "YOUR_PASSWORD",
"device_id": "YOUR_DEVICE_ID",
"room_id": "YOUR_ROOM_ID",
"api_key": "YOUR_API_KEY",
"access_token": "xxxxxxxxxxxxxx",
"bing_api_endpoint": "xxxxxxxxx",
"bing_auth_cookie": "xxxxxxxxxx"
2023-03-05 14:07:25 +00:00
}
```
2023-04-11 03:11:59 +00:00
2023-03-05 14:07:25 +00:00
4. Start the bot:
2023-04-11 03:11:59 +00:00
2023-03-05 14:07:25 +00:00
```
python main.py
```
2023-04-11 03:11:59 +00:00
2023-03-05 14:07:25 +00:00
## Usage
2023-04-11 03:11:59 +00:00
2023-03-05 14:07:25 +00:00
To interact with the bot, simply send a message to the bot in the Matrix room with one of the two prompts:<br>
2023-04-11 03:11:59 +00:00
- `!gpt` To generate a one time response:
2023-04-11 03:11:59 +00:00
2023-03-05 14:07:25 +00:00
```
!gpt What is the meaning of life?
```
2023-04-11 03:11:59 +00:00
2023-03-10 17:01:25 +00:00
- `!chat` To chat using official api with context conversation
2023-04-11 03:11:59 +00:00
2023-03-05 14:07:25 +00:00
```
!chat Can you tell me a joke?
2023-03-10 15:45:38 +00:00
```
2023-04-11 03:11:59 +00:00
2023-03-10 17:01:25 +00:00
- `!bing` To chat with Bing AI with context conversation
2023-04-11 03:11:59 +00:00
2023-03-10 17:01:25 +00:00
```
!bing Do you know Victor Marie Hugo?
```
2023-04-11 03:11:59 +00:00
2023-04-13 15:49:12 +00:00
- `!bard` To chat with Google's Bard
```
!bard Building a website can be done in 10 simple steps
```
2023-03-22 14:41:01 +00:00
- `!pic` To generate an image from Microsoft Bing
2023-04-11 03:11:59 +00:00
2023-03-22 14:41:01 +00:00
```
!pic A bridal bouquet made of succulents
```
2023-04-11 03:11:59 +00:00
2023-03-22 14:41:01 +00:00
## Bing AI and Image Generation
2023-04-11 03:11:59 +00:00
https://github.com/hibobmaster/matrix_chatgpt_bot/wiki/ <br>
2023-03-10 17:01:25 +00:00
![](https://i.imgur.com/KuYddd5.jpg)
2023-03-22 14:41:01 +00:00
![](https://i.imgur.com/3SRQdN0.jpg)
2023-04-13 15:49:12 +00:00
## Thanks
1. [matrix-nio](https://github.com/poljar/matrix-nio)
2. [acheong08](https://github.com/acheong08)
3. [node-chatgpt-api](https://github.com/waylaidwanderer/node-chatgpt-api)