{"id":15524341,"url":"https://github.com/codeforequity-at/botium-connector-witai","last_synced_at":"2025-04-23T07:31:30.189Z","repository":{"id":91176484,"uuid":"207639598","full_name":"codeforequity-at/botium-connector-witai","owner":"codeforequity-at","description":"Botium Connector for wit.ai","archived":false,"fork":false,"pushed_at":"2019-12-08T16:40:18.000Z","size":17,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-29T22:41:18.894Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://www.botium.at","language":"JavaScript","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/codeforequity-at.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":"2019-09-10T18:56:11.000Z","updated_at":"2021-05-08T03:42:30.000Z","dependencies_parsed_at":null,"dependency_job_id":"a86f04e2-0aae-4267-9ac6-4016e5535bd1","html_url":"https://github.com/codeforequity-at/botium-connector-witai","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeforequity-at%2Fbotium-connector-witai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeforequity-at%2Fbotium-connector-witai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeforequity-at%2Fbotium-connector-witai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeforequity-at%2Fbotium-connector-witai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codeforequity-at","download_url":"https://codeload.github.com/codeforequity-at/botium-connector-witai/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250390790,"owners_count":21422783,"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":[],"created_at":"2024-10-02T10:51:01.779Z","updated_at":"2025-04-23T07:31:30.181Z","avatar_url":"https://github.com/codeforequity-at.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Botium Connector for for wit.ai\n\n[![NPM](https://nodei.co/npm/botium-connector-witai.png?downloads=true\u0026downloadRank=true\u0026stars=true)](https://nodei.co/npm/botium-connector-witai/)\n\n[![Codeship Status for codeforequity-at/botium-connector-sapcai](https://app.codeship.com/projects/22e46100-911b-0137-ae8a-4e8cea91d933/status?branch=master)](https://app.codeship.com/projects/356365)\n[![npm version](https://badge.fury.io/js/botium-connector-witai.svg)](https://badge.fury.io/js/botium-connector-witai)\n[![license](https://img.shields.io/github/license/mashape/apistatus.svg)]()\n\nThis is a [Botium](https://github.com/codeforequity-at/botium-core) connector for testing your wit.ai projects.\n\n__Did you read the [Botium in a Nutshell](https://medium.com/@floriantreml/botium-in-a-nutshell-part-1-overview-f8d0ceaf8fb4) articles? Be warned, without prior knowledge of Botium you won't be able to properly use this library!__\n\n## How it works\nBotium connects to your wit.ai using its [Wit Node.js SDK](https://github.com/wit-ai/node-wit). It extracts the NLP information for using with Botium and it's NLP asserters.\n\nYou can assert composite entities too:\n```\nINTENT \u003cCompositeEntityName\u003e.\u003cEntityName\u003e\n```\nor just\n```\nINTENT \u003cCompositeEntityName\u003e\n```\nand\n```\nINTENT_CONFIDENCE \u003cCompositeEntityConfidence\u003e\n```\n\nIt can be used as any other Botium connector with all Botium Stack components:\n* [Botium CLI](https://github.com/codeforequity-at/botium-cli/)\n* [Botium Bindings](https://github.com/codeforequity-at/botium-bindings/)\n* [Botium Box](https://www.botium.at)\n\n## Requirements\n* **Node.js and NPM**\n* a **wit.ai** app\n* a **project directory** on your workstation to hold test cases and Botium configuration\n\n## Install Botium and wit.ai Connector\n\nWhen using __Botium CLI__:\n\n```\n\u003e npm install -g botium-cli\n\u003e npm install -g botium-connector-witai\n\u003e botium-cli init\n\u003e botium-cli run\n```\n\nWhen using __Botium Bindings__:\n\n```\n\u003e npm install -g botium-bindings\n\u003e npm install -g botium-connector-witai\n\u003e botium-bindings init mocha\n\u003e npm install \u0026\u0026 npm run mocha\n```\n\nWhen using __Botium Box__:\n\n_Already integrated into Botium Box, no setup required_\n\n## Connecting wit.ai app to Botium\n\nProcess is very simple, you just need the wit.ai server access token. After creating your app, you can find your access token in the app's Settings tab.\n\nCreate a botium.json with this URL in your project directory:\n\n```\n{\n  \"botium\": {\n    \"Capabilities\": {\n      \"PROJECTNAME\": \"\u003cwhatever\u003e\",\n      \"CONTAINERMODE\": \"witai\",\n      \"WITAI_TOKEN\": \"...\"\n    }\n  }\n}\n```\n\nBotium setup is ready, you can begin to write your [BotiumScript](https://github.com/codeforequity-at/botium-core/wiki/Botium-Scripting) files.\n\n## How to start sample\n\nThere is a small demo in [samples](./samples) with Botium Bindings.\n\nInstall the packages, and run the test:\n```\n\u003e cd ./samples/\n\u003e npm install \u0026\u0026 npm test\n```\n\n## Supported Capabilities\n\nSet the capability __CONTAINERMODE__ to __witai__ to activate this connector.\n\n### WITAI_TOKEN\nGet it from the app's Settings tab in the wit.ai console\n\n### WITAI_CONTEXT\n_Default: empty_\n\nContext JSON object for wit.ai, see [here](https://wit.ai/docs/http/20170307#context_link) for details and format.\n\n### WITAI_APIVERSION\n_Default: empty_\n\nThe API version to use instead of the recommended one\n\n## Open Issues and Restrictions\n* For wit.ai the entity role is an alias for name. You can assert an entity just with alias:\n```\nINTENT \u003cEntityRole\u003e\n```\n* If wit.ai does not recognizes any intent (utterance is not recognized, or utterance has no intent) then Botium will add a none intent: \n```\nINTENT none\n```\n\n* wit.ai supports more intents for a utterance, but Botium does not.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodeforequity-at%2Fbotium-connector-witai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodeforequity-at%2Fbotium-connector-witai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodeforequity-at%2Fbotium-connector-witai/lists"}