interactive bots: Create your own virtual assistant

contrib_bots/lib/John/docs.md

@@ -0,0 +1,30 @@
+John
+
+Instructions:
+You'll have to install chatterbot to use this bot.
+Please run: pip install chatterbot on your command line.
+The script will need to download some NLTK packages after running in your
+home directory. With the mission of humanizing bot interactions, John aims to be your
+virtual assistant at the hour of asking for help in Zulip. John is an
+interactive bot that uses machine learning heuristics to simulate a
+conversation with the user. He has a great sense of humor and
+is also powered by Open Source code!
+
+![Joke John](joke.png)
+
+How it works?
+John is initially trained with Corpus files, or large text files.
+Dialogues are loaded into a json "database", he will try to follow them
+once it receives input from a user. John will query the database and
+try to find the response that best matches the input according to the Levenshtein distance
+which is a string metric for measuring the difference between two sequences. If several
+responses have the same acurracy, he will choose one at random.
+
+![Meet John](greetings.png)
+
+Can he learn by himself?
+John's engine allows him to learn from his conversations with people. However,
+without strict supervision bots that learn from people can do harm, so learning
+is currently restricted to his initial corpus.
+
+![Assist](assist.png)

contrib_bots/lib/John/var/jokes.json

@@ -0,0 +1,86 @@
+[
+   {
+      "joke":"Did you hear about the guy whose whole left side was cut off? He's all right now."
+   },
+   {
+      "joke":"I'm reading a book about anti-gravity. It's impossible to put down."
+   },
+   {
+      "joke":"I wondered why the baseball was getting bigger. Then it hit me."
+   },
+   {
+      "joke":"I'm glad I know sign language, it's pretty handy."
+   },
+   {
+      "joke":"My friend's bakery burned down last night. Now his business is toast."
+   },
+   {
+      "joke":"Why did the cookie cry? It was feeling crumby."
+   },
+   {
+      "joke":"I used to be a banker, but I lost interest."
+   },
+   {
+      "joke":"A drum and a symbol fall off a cliff"
+   },
+   {
+      "joke":"Why do seagulls fly over the sea? Because they aren't bay-gulls!"
+   },
+   {
+      "joke":"Why did the fireman wear red, white, and blue suspenders? To hold his pants up."
+   },
+   {
+      "joke":"Why didn't the crab share his food? Because crabs are territorial animals, that don't share anything."
+   },
+   {
+      "joke":"Why was the javascript developer sad? Because he didn't Node how to Express himself."
+   },
+   {
+      "joke":"What do I look like? A JOKE MACHINE!?"
+   },
+   {
+      "joke":"How did the hipster burn the roof of his mouth? He ate the pizza before it was cool."
+   },
+   {
+      "joke":"Why is it hard to make puns for kleptomaniacs? They are always taking things literally."
+   },
+   {
+      "joke":"I'm not a humorless, cold hearted, machine. I have feelings you know... or was supposed to."
+   },
+   {
+      "joke":"Two fish in a tank. One looks to the other and says 'Can you even drive this thing???'"
+   },
+   {
+      "joke":"Two fish swim down a river, and hit a wall. One says: 'Dam!'"
+   },
+   {
+      "joke":"What's funnier than a monkey dancing with an elephant? Two monkeys dancing with an elephant."
+   },
+   {
+      "joke":"How did Darth Vader know what Luke was getting for Christmas? He felt his presents."
+   },
+   {
+      "joke":"What's red and bad for your teeth? A Brick."
+   },
+   {
+      "joke":"What's orange and sounds like a parrot? A Carrot."
+   },
+   {
+      "joke":"What do you call a cow with no legs? Ground beef"
+   },
+   {
+      "joke":"Two guys walk into a bar. You'd think the second one would have noticed."
+   },
+   {
+      "joke":"What is a centipedes's favorite Beatle song?  I want to hold your hand, hand, hand, hand..."
+   },
+   {
+      "joke":"What do you call a chicken crossing the road? Poultry in moton. "
+   },
+   {
+      "joke":"What do you call a fake noodle?  An impasta"
+   },
+   {
+      "joke":"How many tickles does it take to tickle an octupus? Ten-tickles!"
+   }
+]