{"id":16960567,"url":"https://github.com/randomfractals/americans","last_synced_at":"2025-10-08T13:37:09.823Z","repository":{"id":101631198,"uuid":"73613343","full_name":"RandomFractals/americans","owner":"RandomFractals","description":"Bots demo project of USA census population data","archived":false,"fork":false,"pushed_at":"2018-02-20T15:43:10.000Z","size":3819,"stargazers_count":5,"open_issues_count":2,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-02T22:02:30.019Z","etag":null,"topics":["census-data","facebook-messenger-bot","javascript","jest-tests","population","slack-bot","usa","wit-ai"],"latest_commit_sha":null,"homepage":"https://americans.herokuapp.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RandomFractals.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2016-11-13T12:07:25.000Z","updated_at":"2023-02-06T07:29:58.000Z","dependencies_parsed_at":"2023-06-07T00:45:10.197Z","dependency_job_id":null,"html_url":"https://github.com/RandomFractals/americans","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/RandomFractals/americans","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RandomFractals%2Famericans","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RandomFractals%2Famericans/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RandomFractals%2Famericans/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RandomFractals%2Famericans/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RandomFractals","download_url":"https://codeload.github.com/RandomFractals/americans/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RandomFractals%2Famericans/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270011192,"owners_count":24511902,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-12T02:00:09.011Z","response_time":80,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["census-data","facebook-messenger-bot","javascript","jest-tests","population","slack-bot","usa","wit-ai"],"created_at":"2024-10-13T22:49:25.559Z","updated_at":"2025-10-08T13:37:09.737Z","avatar_url":"https://github.com/RandomFractals.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Americans\n\nAmericans is a hybrid ES5/ES6 node.js chatbot demo app for\nUSA census data pop, biz, trade, incomes, crime, education, and housing stats queries.\n\nThink 'Quick Facts' census data bot you can ping for some USA pop data info:\n\nhttps://www.census.gov/quickfacts/table/PST045216/00\n\nAmericans Bot app concept post: https://www.linkedin.com/pulse/americans-bot-app-taras-novak/\n\n# Project Info\n\nDialogFlow Americans Bot proj. v2.0 beta migration announcement:\n\nhttps://plus.google.com/109626352267904541757/posts/MqaGhe5LXki\n\nNew Americans Bot DialogFlow agent configuration: https://bot.dialogflow.com/americans\n\nOld Americans bot home page: https://americans.herokuapp.com/\n\nMore project info on linkedin: https://www.linkedin.com/pulse/americans-bot-app-taras-novak\n\nSee Twitter devlogs for the latest daily on this project:\n\nhttps://twitter.com/hashtag/AmericansBot?src=hash\n\n---------------------------------------------------------------------------------\n\nOld Americans bot Facebook page: https://www.facebook.com/Americans-1836666999901817/\n\nRetiring Wit.AI bot brains: https://wit.ai/RandomFractals/americans/stories\n\nMore census data stats coming to chat clients near you soon.\n\n# Latest FB Messenger interface v.: \n\n![Alt text](https://github.com/RandomFractals/americans/blob/master/screens/AmericansBotMVP.png?raw=true \n \"latest\") \n\n# Americans bot home page: https://americans.herokuapp.com/\n\n![Alt text](https://github.com/RandomFractals/americans/blob/master/screens/AmericansBotHomePageTake3.png\n \"Americans Bot home page dev in progress...\") \n\n## Build\n\n```bash\ngit clone https://github.com/RandomFractals/americans\ncd americans\nnpm install\n```\n\n## Config\n```bash\ncp .env.template .env\n```\nFollow instructions in .env config file to procure required tokens \nand service api access keys for api.ai, Wit.ai, FB Messenger, Slack, and Census API data calls.\n\nNote: only WIT_AI_TOKEN or API_AI_TOKEN, and CENSUS_DATA_API_KEY .env vars are required for local bot.js CLI runs.\n\n## Test\n### Jest\n```bash\nnpm test \n```\n\n### DialogFlow CLI\n\n```\nnode dialogflow-cli --help\n```\n\n### Interactive WitAI CLI (Facebook Bots AI interface API command line test)\n```bash\nnode witai-cli\n``` \n\n## Run\n```bash\nnpm start \n```\n\n## Dev Guides\n\n* http://blog.potatobon.com/2018/01/26/google-assistant-vs-amazon-echo/\n\n* https://codelabs.developers.google.com/?cat=Assistant\n\n* https://github.com/dialogflow/dialogflow-fulfillment-nodejs#quick-start\n\n* https://github.com/dialogflow/dialogflow-nodejs-client-v2\n\n* https://cloud.google.com/nodejs/getting-started/hello-world\n\n* https://plus.google.com/communities/103318168784860581977 - DialogFlow dev community\n\n--------------------------------------------------------------------------\n\n## Retring Americans Bot v1.4 alpha dev docs \n\n*NOTE:* these are most likely out of date since both wit.ai and api.ai finished their betas\nand went in totally different directions focusing on things most important for their target dev and user audience and platforms.\n\nSee FB sunsetting their bot engine stories post here: https://wit.ai/blog/2017/07/27/sunsetting-stories\nstories migration tutorial: https://github.com/wit-ai/wit-stories-migration-tutorial\nand updated wit.ai API docs: https://wit.ai/docs/http/20170307#post--apps-link\n\nGoogle rebranded to DialogFlow and extended their bots reach, \nwhich will be the focus of further docs and code updates of this v2.0 repo of Americans bot.\n\n----------------------------------------------------------------------------\n\nGoogle api.ai docs:\n\n* https://docs.api.ai/docs/authentication\n\nWit.AI Node.js SDK:\n\n* https://github.com/wit-ai/node-wit\n\nFB Messenger Platform Quick Start:\n\n* https://developers.facebook.com/docs/messenger-platform/quickstart\n\nSlack API:\n\n* https://api.slack.com/slack-apps\n\n## Credits\nSome borrowed and refactored code from:\n\n* https://github.com/jw84/messenger-bot-tutorial\n* https://github.com/hunkim/Wit-Facebook\n* https://github.com/girliemac/slack-httpstatuscats\n\n\n# License\n\nCopyright © 2018 Random Fractals, Inc.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this software except in compliance with the License.\nYou may obtain a copy of the License at\n\nhttp://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frandomfractals%2Famericans","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frandomfractals%2Famericans","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frandomfractals%2Famericans/lists"}