{"id":20441118,"url":"https://github.com/ari-hacks/covid-chatbot","last_synced_at":"2026-03-12T14:38:10.867Z","repository":{"id":38962256,"uuid":"257662473","full_name":"ari-hacks/covid-chatbot","owner":"ari-hacks","description":"🤖 A Twilio Hackathon Project ","archived":false,"fork":false,"pushed_at":"2023-02-14T21:47:29.000Z","size":616,"stargazers_count":4,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-07T23:39:26.488Z","etag":null,"topics":["chatterbot","covid19","fastapi","heroku","python","twilio-api"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ari-hacks.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-04-21T17:15:00.000Z","updated_at":"2025-01-05T12:49:42.000Z","dependencies_parsed_at":"2024-11-15T09:44:00.367Z","dependency_job_id":null,"html_url":"https://github.com/ari-hacks/covid-chatbot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ari-hacks/covid-chatbot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ari-hacks%2Fcovid-chatbot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ari-hacks%2Fcovid-chatbot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ari-hacks%2Fcovid-chatbot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ari-hacks%2Fcovid-chatbot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ari-hacks","download_url":"https://codeload.github.com/ari-hacks/covid-chatbot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ari-hacks%2Fcovid-chatbot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30428471,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-12T14:34:45.044Z","status":"ssl_error","status_checked_at":"2026-03-12T14:09:33.793Z","response_time":114,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chatterbot","covid19","fastapi","heroku","python","twilio-api"],"created_at":"2024-11-15T09:30:03.801Z","updated_at":"2026-03-12T14:38:10.839Z","avatar_url":"https://github.com/ari-hacks.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Covid-19 ChatBot 🤖\n\n![MIT license](https://img.shields.io/badge/License-MIT-blue.svg) [![Build Status](https://travis-ci.com/ari-hacks/covid-chatbot.svg?branch=master)](https://travis-ci.com/ari-hacks/covid-chatbot)\n\n\n## About\n\nThis is a simple ChatBot that communicates via Twilio's API on WhatsApp. The Bot gives Covid statistics from the US \u0026 the UK. It also provides some positive news articles to read in light of recent times.\n\n### How it works\n\nUsers interact with WhatsApp to communicate with the ChatBot. \nThe Bot replies to greetings along with different variations of the following questions.\n\n### Sample Questions:\n\nInput | Output| \n---------|----------|\nGreeting!| Hi | \nHi, How is it going? | Good | \nuk confirmed cases? | Confirmed Uk Cases 165221 | \nHow many uk confirmed cases? | Confirmed Uk Cases 165221 \nWhat are the us covid stats? | United States Stats: confirmed: 1055303 recovered: 144423 critical: 18665 deaths: 61112\nuk stats |United Kingdom Stats: confirmed: 165221 recovered: 1918 critical: 1559 deaths: 26097\nwhat are the uk covid stats? | United Kingdom Stats: confirmed: 165221 recovered: 1918 critical: 1559 deaths: 26097\nhow many us recovered cases are there? | Recovered Us Cases 147411\ntell me some positive news, please? | https://www.theguardian.com/news/2020/apr/13/coronavirus-looking-for-good-news-run-for-heroes-and-an-opera-singing-doctor\n\n\n\n## Features\n\n- Python web framework using [FastApi](https://fastapi.tiangolo.com/)\n- [Twilio](https://www.twilio.com/whatsapp) API for WhatsApp \n- Automated responses and bot training with [Chatterbot](https://chatterbot.readthedocs.io/en/stable/)\n- Testing with [`requests_mock`](https://pypi.org/project/requests-mock/) and [`pytest`](https://docs.pytest.org/en/latest/)\n- Automated CI testing using [Travis CI](https://travis-ci.com/github/ari-hacks/covid-chatbot)\n- Project specific environment variables using `.env` \n- Built-in API documentation with Open API [docs](https://covid-chatterbot.herokuapp.com/docs)\n- One click deploy buttons for Heroku\n\n\n## Set up\n\n### Requirements\n\n- [Python](https://www.python.org/) 3.8.1\n- A Twilio account - [sign up](https://www.twilio.com/whatsapp)\n- [WhatsApp](https://www.whatsapp.com/)\n- [ngrok](https://ngrok.com/)\n\n\n### Local development\n\nAfter the above requirements have been met:\n\n1. Clone this repository and `cd` into it\n\n```bash\ngit clone https://github.com/ari-hacks/covid-chatbot.git\ncd covid-chatbot\n```\n\n2. Install dependencies\n\n```bash\npip3 install chatterbot==1.0.4\npip3 install twilio \npip3 install pytest \npip3 install uvicorn    \npip3 install fastapi  \npip3 install nltk   \npip3 install httpx\npip3 install requests_mock         \n```\n\n4. Run the application\n\n```bash\nuvicorn app.main:app --reload \n\n#uvicorn runs on http://127.0.0.1:8000    \n```\n\n5. Next we need to unzip the ngork [download](https://ngrok.com/download). Ngork creates a secure public tunnel for us to use when communicating with WhatsApp via the twilio API. From your terminal run the following command: \n\n```bash\n./ngrok http 8000\n\n#this port must match the app port\n```\n6. After you have created your [twilio account](https://www.twilio.com/whatsapp) navigate to the [dashboard's sandbox](https://www.twilio.com/console/sms/whatsapp/sandbox) in the field titled ` when a message comes in ` enter the generated forwarding address from your terminal and save. The forwarding url will look like this: \n\n![Alt text](/ngork_ex.png?raw=true \"Demo\")\n\n7. Next follow these [ twilio instructions](https://www.twilio.com/console/sms/whatsapp/learn) to connect your account to WhatsApp and send a message 🎉🎉🎉\n\n### Tests\n\nYou can run the tests locally by typing:\n\n```bash\npytest\n```\n### Troubleshooting\nIf you run into issues with nltk \n\n```bash\n#error in terminal related to ssl verification\n#solution - in the terminal run the following commands, make sure you change the version of python accordingly \n\u003e\u003e/Applications/Python 3.8/Install Certificates.command\n\n\u003e\u003ePython3\n\n\u003e\u003eImport nltk\n\n\u003e\u003enltk.download() \n```\n\n### Cloud deployment\n\nTo try this application locally, you can deploy it to Heroku. \n\n```bash \n#check if app is running with this endpoint \nhttps://heroku-porject.herokuapp.com/twilio/health-check\n\n#add this endpoint into your twilio snadbox\nhttps://heroku-porject.herokuapp.com/twilio/bot\n```\n\n\nPlease [Sign up](https://www.heroku.com/)  before Deploying. \n\n [![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy)                                               \n\n\n## License\n\n[MIT](http://www.opensource.org/licenses/mit-license.html)\n\n## Disclaimer\n\nNo warranty expressed or implied. Software is as is.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fari-hacks%2Fcovid-chatbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fari-hacks%2Fcovid-chatbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fari-hacks%2Fcovid-chatbot/lists"}