YourMomBot

YourMomBot is a discord bot that reads at text sent by users in a discord channel, and makes your mom jokes from them.

Modified from [andylolu2/YourMumBot]s(https://github.com/andylolu2/YourMumBot).

⚠️ DISCLAIMER ⚠️

THIS MODEL IS PURPOSEFULLY DESIGNED TO BE INSULTING.

THIS BOT IS CREATED FOR COMEDIC PURPOSES ONLY. PLEASE BE AWARE THAT CONTENT SENT BY YOURMOMBOT CAN BE VERY OFFENSIVE.

DO NOT use this bot if anyone in the server would find it offensive / inappropriate.

I am NOT responsible for misuse of this bot / code. Misuse includes but is not limited to:

Using this bot to offend someone
Using this bot in stituations where someone would find it offensive
Causing undesired results by using this code

Up and Running
Sample outputs
How it works
- Pipeline
Discord Bot
API
- Endpoint
- Responses
Run your own API / Bot
- Pre-Built Docker Images
- Memory requirements

Up and Running

Add Your Mom to your discord channel!

Click here 👇

Try the API endpoint: here

Sample outputs

User: Flat earthers think that the earth is flat
Bot: Flat earthers think that your mom is flat

User: League of legends is such a shit game
Bot: Your mom is such a shit game

User: Today is a good day. You are very tall.
Bot: Today is your mom. Your mom is very tall.

How it works

YourMomBot makes use of 3 main nlp models / tools:

Pipeline

The CoreNLP library constituency parser is used to identify noun phrases (NP) in a input sentence.
These NPs serves as potential places in the sentence where we can substitute the NP with the string your mom. This works surprisingly well.
For each of these potential substitutions, we use Detoxify to rate the toxicity of the sentence. We then pick the sentence that has the highest toxicity.

At various points while processing the input, language tools is used to correct grammatical mistakes of the (potential) output sentences.

For example, this might be due to substitution of
`you` with `your mom` in `You are very tall`, which leads
to the grammatically incorrect output `your mom are very tall`.

`language tools` tries to fix this problem.

Discord Bot

No of requests

YourMomBot is currently hosted on a small EC2 instance on AWS. YourMomBot will only process at most 1 requests at the same time. Any other requests will be ignored.

Input size

YourMomBot only processes user inputs that are shorter than 150 characters and shorter than 25 words. This is to ensure quick processing for low latency and prevent a single request to hog to server.

Latency

Latency is usually around 500-1000 ms.

API

Endpoint

There is an api endpoint available at http://3.211.27.31/yourmomify. Docs a can be read via this link

Responses

Response code

200: Request was successful.
422: Request body is not valid:
- msg can only contain ascii characters.
- msg length must be less than or equal to 150 characters.
- msg must contain than or equal to 25 words.
500: Internal server error. Please post an issue.
503: Server busy processing another request. (It can only process one request at a time.)

Run your own API / Bot

Source code is available here.

To run do

docker-compose up -d

Pre-Built Docker Images

Memory requirements

1GB of RAM is barely sufficient to run all related services for this model. Swap file is needed to prevent Out-Of-Memory errors.

tctree333/YourMomBot