A Facebook messenger bot that allows users to chat with other people on Facebook anonymously.
You can find it live here.
I started out building BlindChat just to try out the messenger platform of Facebook and to try to build something usable out of it while learning in the process. It is more of an app rather than an AI chatbot. The outcome got a bit of traction and hence I improved certain parts of it, however, most of the code may be in an unorganized condition since those are built for quick prototyping.
BlindChat is currently hosted on Heroku and uses their offered database. Thus, the code and setup are written for it. If you don't want to use Heroku, you'll have to modify the code in a few places but if you are okay with Heroku, then you are just fine. It helps to have a bit of knowledge setting up a messenger bot.
Clone the repository by opening up your terminal/cmd and running the following command to set up your local repository:
git clone https://github.com/mayukh18/BlindChat.git/
Create a messenger app on Facebook. Add and configure the webhook and be certain to note down both the Access Token and Verify Token.
Install the Heroku CLI toolbelt if you don't already have it. Then create an app on Heroku by opening up your terminal/cmd and running the following command:
heroku create yourappname
Run the following command to install the required libraries to your local environment:
pip install -r requirements.txt
Run the following command to set up a Postgres database with Heroku:
heroku addons:add heroku-postgresql:hobby-dev
Next run the following lines:
heroku run python
>> import os
>> os.environ.get('DATABASE_URL')
Open the config.py file and replace 'YOUR_FACEBOOK_APP_ACCESS_TOKEN'
and 'FACEBOOK_APP_VERIFY_TOKEN'
with the respective tokens from Step 2, replace 'APP_URL'
with your Heroku app URL https://yourappname.herokuapp.com/
and finally, replace 'YOUR_DATABASE_URI'
with your database URI from step 6..
Next, to set up and migrate the models into your database, run
python manage.py db init
python manage.py db migrate
python manage.py db upgrade
Lastly, deploy to Heroku with the following command, and Voila!
git push heroku master
Note:
All contributions are welcome. Please discuss your ideas on the community first to avoid clash of others working on the same thing. A few issues are marked as "beginner friendly" which are suitable for beginners to try out.
Ask in Issues if you are not sure on something. Cheers!