Skip to content

Latest commit

 

History

History
117 lines (77 loc) · 3.87 KB

README.md

File metadata and controls

117 lines (77 loc) · 3.87 KB
Raw

Upsy: Your new mate on Discord & Slack. Powered by AI.

Note

This project is a Community Project.

The project is maintained and supported by the community. Upstash may contribute but does not officially support or assume responsibility for it.

Upsy is an open source Discord & Slack bot that provides fast, accurate answers whenever you have a question.

Discord Setup

Create a Discord Application

Create an application at “https://discord.com/developers/applications".

Privileged Gateway Intents

To enable the bot to access the message history, you need to enable the Privileged Gateway Intents. Go to the Bot section of your Discord application and enable the MESSAGE CONTENT INTENT and SERVER MEMBERS INTENT.

Default Install Settings

After choosing Install Link (Settings > Installation) as Discord provided link, you need to update scopes and permissions under Default Install Settings as follows:

Scopes: applications.commands, bot

Bot Permissions: Send Messages, Read Message History, Use Slash Commands, Add Reactions, Embed Links, Read Messages/View Channels, Send Messages in Threads, Use External Emojis, Send TTS Messages.

Get your Bot Token

Reset token in the bot section of your Discord application. Your token should start with "MTIzMz…"

Put your token into config/config.json file

{
    "client": {
        "token": "MTIzMz...",
    },
}

Get your Application ID and put it into config/config.json file

You can find your application ID in the General Information section of your Discord application.

{
    "client": {
		    "id":"123333333333333333",
        "token": "MTIzMz...",
    },
}

Set the environment variables either in Dockerfile or fly.toml:

OPENAI_API_KEY=""
UPSTASH_REDIS_REST_TOKEN=""
UPSTASH_REDIS_REST_URL=""
UPSTASH_VECTOR_REST_TOKEN=""
UPSTASH_VECTOR_REST_URL=""

You can either run the bot locally or deploy it to Fly.io

Local Deployment

docker build -f discord/Dockerfile -t upsy-discord .
docker run -d -p 3001:3001 upsy-discord

Fly.io Deployment

fly launch
fly deploy

Don't forget to run fly scale count 1 to make sure only one instance is running.

Add the bot to your Discord server

To add the bot to your Discord server, you need to generate an OAuth2 URL. Go to the Installation section of your Discord application and under Install Link, select the discord provided link. You can then add the bot to your server.

At this point, you should see the bot online in your Discord server.

Slack Setup

Checkout Upsy Slack documentation.

Notes:

Your initial discord commands will be registered at docker build time. For deleting, updating or adding new commands, you need to run npm run commands:* commands.

Discord template used in this project is: Discord-Bot-TypeScript-Template

Contributing

Upsy is a work in progress, so we'll add more features and improve the current ones. We've collected a few ideas we believe would make Upsy an even more helpful companion:

  • Add documents to the context so that Upsy can memorize and use them as context.
  • Add a web interface to manage Upsy so you can add new information to Upsy’s memory via the web interface and configure Upsy’s behavior
  • More proactive Upsy - Upsy will initiate conversations with you or respond to welcome, birthday, etc. messages
  • Ability to choose personal characters for Upsy, such as friendlier, funnier, or more serious

If one of these ideas sounds like something you'd like to work on, contributions are very welcome! You can contribute by adding new features, fixing bugs, improving the documentation, writing blog posts, or by sharing Upsy on social media.