https://github.com/csvance/armchair-expert

Machine Learning Chatbot
https://github.com/csvance/armchair-expert

ai bot discord machine-learning markov nlp python twitter

Last synced: about 1 month ago
JSON representation

Machine Learning Chatbot

• Host: GitHub
• URL: https://github.com/csvance/armchair-expert
• Owner: csvance
• License: mit
• Created: 2016-07-11T04:13:30.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2021-04-07T23:20:47.000Z (over 3 years ago)
• Last Synced: 2024-08-04T05:05:00.993Z (5 months ago)
• Topics: ai, bot, discord, machine-learning, markov, nlp, python, twitter
• Language: Python
• Homepage:
• Size: 3.24 MB
• Stars: 55
• Watchers: 9
• Forks: 18
• Open Issues: 17
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# About

armchair-expert is a chatbot inspired by old Markov chain IRC bots like PyBorg. It regurgitates what it learns from you in unintentionally hilarious ways.

## Features

- Uses NLP to select the most optimal subjects for which to generate a response

- Uses a Recurrent Neural Network (RNN) to structure and capitalize the output, mimicking sentence structure and capitalization of learned text

- Learns new words in real-time with an n-gram markov chain, which is positionally aware of the distances between different words, creating a more coherent sentence

## Requirements

- 3+ GB of RAM

- python 3.6+

- keras (Tensorflow backend)

- spaCy 2.0.0+

- spacymoji

- numpy

- tweepy

- discord.py

- sqlalchemy

## Setup & Training

- Copy config/armchair_expert.example.py to config/armchair_expert.py

- Copy config/ml.example.py to config/ml.py

- Make sure you have the spacy 'en' dataset downloaded: 'python -m spacy download en'

- I would suggest import some data for training before starting the bot. Here is one example: https://github.com/csvance/armchair-expert/blob/master/scripts/import_text_file.py

- Every time the bot starts it will train on all new data it acquired since it started up last

- The bots sentence structure model is only trained once on initial startup. To train it with the most recent acquired data, start the bot with the --retrain-structure flag. If you are noticing the bot is not generating sentences which the structure of learned material, this will help.

# Connectors

## Twitter

- You will need to create an application on the twitter devleoper site on your bot's twitter account https://apps.twitter.com

- After creating it, assign it permissions to do direct messages (this isn't default)

- Create an access token for your account

- Copy config/twitter.example.py to config/twitter.py

- Fill in the tokens and secrets along with your handle

- python armchair_expert.py

## Discord

- You will need to register a bot with Discord: https://discordapp.com/developers/applications/me#top

- Once you register it take note of the Client ID, Username, and Token

- Copy config/discord.example.py to config/discord.py and fill in the relevant fields

- python armchair_expert.py

- When the bot starts you should see a message print to the console containing a link which will allow you to join the bot to a server.