/americans

Bots demo project of USA census population data

Primary LanguageJavaScript

Americans

Americans is a hybrid ES5/ES6 node.js chatbot demo app for USA census data pop, biz, trade, incomes, crime, education, and housing stats queries.

Think 'Quick Facts' census data bot you can ping for some USA pop data info:

https://www.census.gov/quickfacts/table/PST045216/00

Americans Bot app concept post: https://www.linkedin.com/pulse/americans-bot-app-taras-novak/

Project Info

DialogFlow Americans Bot proj. v2.0 beta migration announcement:

https://plus.google.com/109626352267904541757/posts/MqaGhe5LXki

New Americans Bot DialogFlow agent configuration: https://bot.dialogflow.com/americans

Old Americans bot home page: https://americans.herokuapp.com/

More project info on linkedin: https://www.linkedin.com/pulse/americans-bot-app-taras-novak

See Twitter devlogs for the latest daily on this project:

https://twitter.com/hashtag/AmericansBot?src=hash


Old Americans bot Facebook page: https://www.facebook.com/Americans-1836666999901817/

Retiring Wit.AI bot brains: https://wit.ai/RandomFractals/americans/stories

More census data stats coming to chat clients near you soon.

Latest FB Messenger interface v.:

Alt text

Americans bot home page: https://americans.herokuapp.com/

Alt text

Build

git clone https://github.com/RandomFractals/americans
cd americans
npm install

Config

cp .env.template .env

Follow instructions in .env config file to procure required tokens and service api access keys for api.ai, Wit.ai, FB Messenger, Slack, and Census API data calls.

Note: only WIT_AI_TOKEN or API_AI_TOKEN, and CENSUS_DATA_API_KEY .env vars are required for local bot.js CLI runs.

Test

Jest

npm test 

DialogFlow CLI

node dialogflow-cli --help

Interactive WitAI CLI (Facebook Bots AI interface API command line test)

node witai-cli

Run

npm start 

Dev Guides


Retring Americans Bot v1.4 alpha dev docs

NOTE: these are most likely out of date since both wit.ai and api.ai finished their betas and went in totally different directions focusing on things most important for their target dev and user audience and platforms.

See FB sunsetting their bot engine stories post here: https://wit.ai/blog/2017/07/27/sunsetting-stories stories migration tutorial: https://github.com/wit-ai/wit-stories-migration-tutorial and updated wit.ai API docs: https://wit.ai/docs/http/20170307#post--apps-link

Google rebranded to DialogFlow and extended their bots reach, which will be the focus of further docs and code updates of this v2.0 repo of Americans bot.


Google api.ai docs:

Wit.AI Node.js SDK:

FB Messenger Platform Quick Start:

Slack API:

Credits

Some borrowed and refactored code from:

License

Copyright © 2018 Random Fractals, Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this software except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.