{"id":15595473,"url":"https://github.com/cdimascio/nlu-news-web","last_synced_at":"2026-05-16T13:04:38.748Z","repository":{"id":83296724,"uuid":"114940190","full_name":"cdimascio/nlu-news-web","owner":"cdimascio","description":"Sample application using Watson Natural Language Understand and IBM Cloud Functions","archived":false,"fork":false,"pushed_at":"2017-12-30T05:01:46.000Z","size":2925,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-04T10:57:20.990Z","etag":null,"topics":["dbpedia","ibm-cloud","ibm-cloud-functions","openwhisk","vue","watson","watson-natural-language"],"latest_commit_sha":null,"homepage":"https://nlu-web.mybluemix.net","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/cdimascio.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":"2017-12-20T23:21:47.000Z","updated_at":"2017-12-28T19:45:04.000Z","dependencies_parsed_at":"2023-07-01T15:45:44.732Z","dependency_job_id":null,"html_url":"https://github.com/cdimascio/nlu-news-web","commit_stats":{"total_commits":46,"total_committers":1,"mean_commits":46.0,"dds":0.0,"last_synced_commit":"99e944417bbe62e3805bbacacda82e9f0516e2f7"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdimascio%2Fnlu-news-web","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdimascio%2Fnlu-news-web/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdimascio%2Fnlu-news-web/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdimascio%2Fnlu-news-web/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cdimascio","download_url":"https://codeload.github.com/cdimascio/nlu-news-web/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246177290,"owners_count":20735936,"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","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":["dbpedia","ibm-cloud","ibm-cloud-functions","openwhisk","vue","watson","watson-natural-language"],"created_at":"2024-10-03T01:00:25.125Z","updated_at":"2026-05-16T13:04:33.712Z","avatar_url":"https://github.com/cdimascio.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# nlu-web\n\nA sample application that uses Watson Natural Language Understanding, DBpedia, and IBM Cloud Functions (OpenWhisk). \n\u003cdiv align=\"center\" style=\"text-align: center;\"\u003e\n\u003cimg src=\"./assets/nlu.svg\" width=\"120\" height=\"120\"/\u003e\n\u003cimg src=\"./assets/whisk.svg\" width=\"120\" height=\"120\"/\u003e\n\u003c/div\u003e\n\u003cbr\u003e\n\nThe client application is implemented with Vue.js. The UI enables a user to enter a url, preferably one that references a news article. The UI invokes a backend that analyzes the article's contents, identifies a subset of relevant entities, then looks up their details using DBpedia. Finally, the results are rendered as cards. Entities with locations will appear on a Google Map.\n\nThe backend is implemented using IBM Cloud Functions.\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"./assets//example.png\" width=\"80%\"/\u003e\n\u003c/p\u003e\n\n## Try it out\nTo see the live workkng demo, navigate to [https://nlu-web.mybluemix.net](https://nlu-web.mybluemix.net)\n\n## Prerequisities\n- Required [IBM Cloud account](https://www.bluemix.net). Lite / Free tier is sufficient.\n\n- A [Watson Natural Language Understanding](https://console.bluemix.net/catalog/services/natural-language-understanding) service instance on IBM Cloud.\n\n## Setup\n\n### Server\n\n1. Login and set your target organization and space\n\n\t```shell\n\tbx login\n\tbx target -o \u003cYOUR-ORGANIZATION\u003e -s \u003cYOUR-SPACE\u003e\n\t```\n\n2. Apply your Watson Natural Language Understanding service credentials\n\n\t```\n\tvi server/index.js\n\t```\n\tNote: `:wq!` will save an exit from `vi`\n\t\n3. Replace line `\u003cYOUR-USERNAME\u003e` and `\u003cYOUR-PASSWORD\u003e` with your service credentials\n\n\t```javascript\n\tconst nlu = new NaturalLanguageUnderstandingV1({\n\t  username: '\u003cYOUR-USERNAME\u003e',\n\t  password: '\u003cYOUR-PASSWORD\u003e',\n\t  version_date: '2017-02-27',\n\t})\n\t```\n\n4. Deploy the OpenWhisk action (IBM Cloud Function)\n\n\t```shell\n\t bx wsk action update /\u003cYOUR-ORGANIZATION\u003e_\u003cYOUR-SPACE\u003e/demo/nlu_analyze index.js --web true --kind nodejs:8\n\t```\n\n### Client\n\n1. Change the endpoint url to reference your new action's endpoint\n\n\t```shell\n\tvi src/config.js\n\t```\n\t\n\t```javascript\n\texport const nluNewsApiRoot = 'https://openwhisk.ng.bluemix.net/api/v1/web/\u003cYOUR-ORGANIZATION\u003e_\u003cYOUR-SPACE\u003e/demo'\n\t```\n\n2. Install dependencies\n\n```shell\nnpm install\n```\n\n## Run (locally)\n1. Install dependencies\n\n\t```shell\n\tnpm start\n\t```\n\n2. Navigate to [http://localhost:8080](http://localhost:8080)\n\n## Deploy (IBM Cloud)\n1. Open `./manifest.yml` and update `name` and `host` with `\u003cYOUR-USERNAME\u003e-nlu-web`\n\n2. Build for production\n\n\t```shell\n\tnpm run build\n\t```\n\n3. Deploy\n\n\t```shell\n\tcf push\n\t```\n\n4. Navigate to [https://YOUR-USERNAME.mybluemix.net](https://YOUR-USERNAME.mybluemix.net)\n\n## License\nMIT\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcdimascio%2Fnlu-news-web","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcdimascio%2Fnlu-news-web","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcdimascio%2Fnlu-news-web/lists"}