mirror of
https://github.com/Paillat-dev/Botator.git
synced 2026-01-02 01:06:19 +00:00
90 lines
5.4 KiB
Markdown
90 lines
5.4 KiB
Markdown
# Botator
|
|
Botator is a discord bot that binds openai's gpt3 AI with discord. You will be able to take the conversation with the AI into a specific channel that you created.
|
|
|
|
|
|
# Adding the bot to your discord server
|
|
In order to add the bot to your discord server, you will need an OpenAI API key. You can create an account and take one [here](https://beta.openai.com/account/api-keys). **Please note that you'll have 18 free credits when creating your account. They will be slowly used, and will expire 3 months after you created your accound, and when they gave all been used, you'll need to buy new tokens. You can check your tokens usage [here](https://beta.openai.com/account/usage).**
|
|
|
|
You can add the bot to your server by clicking [here](https://discord.com/api/oauth2/authorize?client_id=1046051875755134996&permissions=2214808576&scope=applications.commands%20bot). **PLEASE NOTE THAT WE ARE NOT RESPONSIBLE FOR ANY MISUSE YOU'LL DO WITH THE BOT..**
|
|
|
|
Then, run the following commands to set your bot up:
|
|
|
|
First **/setup**, define the channel you want the bot to talk into and your OPENAI api key.
|
|
|
|
Then, if you want, **/advanced** to define some more advanced parameters..
|
|
|
|
Please note that we can possibly log the messages that are sent for **no more than 24h**, and that we will store your openai API key. You can always delete your API key from our servers by doing **/delete**. Please note that this action is irreversible.
|
|
|
|
You can now enable your bot by doing **/enable**.
|
|
|
|
You can always disable the bot by doing **/disable** and delete your api key from our server by doing **/delete**.
|
|
|
|
# Commands reference
|
|
*/setup* - Setup the bot
|
|
|
|
*/enable* - Enable the bot
|
|
|
|
*/disable* - Disable the bot
|
|
|
|
*/advanced* - Set the advanced settings
|
|
|
|
*/advanced_help* - Get help about the advanced settings
|
|
|
|
*/enable_tts* - Enable the Text To Speech
|
|
|
|
*/disable_tts* - Disable the Text To Speech
|
|
|
|
*/delete* - Delete all your data from our server
|
|
|
|
*/cancel* - Cancel the last message sent by the bot
|
|
|
|
*/default* - Set the advanced settings to their default values
|
|
|
|
*/help* - Show this command list
|
|
|
|
# Support me
|
|
You can support me by getting Botator premium, or donating [here](https://www.buymeacoffee.com/paillat). More informations about botator premium here below:
|
|
### Why?
|
|
At the beginning, Botator was just a project between friends, but now many people are using it, so we need something to pay for our servers. Premium is also a way to support us and our work.
|
|
### Is this mandatory?
|
|
Not at all! You can still continue using botator for free, but in order to limit our servers overload, we limit your requests at 500 per server per day.
|
|
|
|
### What are my advantages with premium?
|
|
With premium, we will increase the maximal number of requests to 5000 for the server of your choice. You will also have access to exclusive Discord channels and get help if you want to self-host Botator. Discord server self promote and "support us" messages will not be shown on this server
|
|
|
|
### Am I going to have unlimited tokens with premium?
|
|
No! With premium, Botator will still use tokens from YOUR OpenAI account, but you will be able to use it 5000 times per day instead of 500.
|
|
|
|
### How much doe it cost?
|
|
Premium subscription costs 1$ per month.
|
|
|
|
### How can I get premium?
|
|
First join our discord server [here](https://discord.gg/pB6hXtUeDv).
|
|
Then subscribe to botator premium by clicking here:
|
|
|
|
<a href="https://www.buymeacoffee.com/paillat"><img src="https://img.buymeacoffee.com/button-api/?text=Get botator premium&emoji=&slug=paillat&button_colour=5F7FFF&font_colour=ffffff&font_family=Inter&outline_colour=000000&coffee_colour=FFDD00" /></a>
|
|
|
|
Then, link your discord account to BuyMeACoffe by following [these instructions](https://help.buymeacoffee.com/en/articles/4601477-how-do-i-access-my-discord-role).
|
|
After that you will normally be able to access some new channels in our discord server. In the Verify Premium channel, run the /premium_activate command and give your server's ID. You can learn about how to get your server's ID by clicking [here](https://support.discord.com/hc/en-us/articles/206346498-Where-can-I-find-my-User-Server-Message-ID-). If you have any question, you can ask here: [help-getting-premium](https://discord.com/channels/1050769643180146749/1050828186159685743).
|
|
|
|
# ToDo
|
|
- [ ] add image recognition
|
|
- [ ] When chatgpt API is released, add that api instead of davinci-003
|
|
- [ ] Publish a GOOD docker image on dockerhub and add some more instructions about how to selfhost
|
|
- [x] Organize code in COGs
|
|
- [ ] Add a log and updates channel option and a way for devs to send messages to that channel on all servers.
|
|
- [ ] Add uses count reset after 24h
|
|
- [ ] Add moderation.
|
|
- [x] add way to consider the answers to the bot's messages.
|
|
<!--
|
|
|
|
# Docker
|
|
You can run this bot with docker. First clone this repository. Now replace the text into the key.txt file that you will find i#nto the ./Botator/docker/Build directory with your **DISCORD** API key. After that,run the following command in the /Botator/docker/Build directory.
|
|
|
|
`docker build . -t botator:latest --no-cache`
|
|
|
|
Now create a directory called `botator` where you want the database files to be stored, and run the following command into that directory to run the container.
|
|
|
|
`docker run -d --name botatordef -v `**`your botator folder directory`**`:/Botator/database botator:latest`
|
|
-->
|