Ready for Bot Framework V4 run-with-F5 NPM-friendly repository package based bot factory server which includes support for Excel, an React.js bot web application & several features including Whatsapp and auto-ngrok.
Switch branches/tags
Clone or download
rodrigorodriguez chore(release): 1.0.5 [skip ci]
## [1.0.5](1.0.4...1.0.5) (2018-11-18)

### Bug Fixes

* **config:** Try to fix CI. ([780a177](780a177))
* **config:** Try to fix CI. ([240e905](240e905))
* **config:** Try to fix CI. ([ae8e2bc](ae8e2bc))
Latest commit d4d0036 Nov 18, 2018
Failed to load latest commit information.
.github Create requirement Jul 15, 2018
.vscode fix(code): Improvements on CODE_OF_CONDUCT and prettify. Nov 17, 2018
docs Add files via upload Nov 11, 2018
packages fix(code): Improvements on CODE_OF_CONDUCT and prettify. Nov 17, 2018
src fix(config): TSLint parsed on all files. Nov 12, 2018
.deployment Initial import. Apr 21, 2018
.gitattributes TSLint fixing. Nov 11, 2018
.gitignore fix(config): Try to fix CI. Nov 18, 2018
.npmignore fix(config): Try to fix CI. Nov 18, 2018
.nycrc Added CI and unit test infrastructure; updated packages. Nov 11, 2018
.prettierrc TSLint fixing. Nov 11, 2018
.travis.yml fix(config): Try to fix CI. Nov 18, 2018 fix(ci): semantic release plugins. Nov 12, 2018 fix(code): Improvements on CODE_OF_CONDUCT and prettify. Nov 17, 2018 Initial import. Apr 21, 2018
LICENSE.txt Initial import. Apr 21, 2018 Update Nov 18, 2018
deploy.cmd Now tsc outputs the version. Sep 27, 2018
gbot.cmd Trying to fix npm run build on default.gbui. Sep 25, 2018
greenkeeper.json chore: add Greenkeeper config file Nov 12, 2018
logo.png New logo. Sep 2, 2018
package-lock.json fix(config): Try to fix CI. Nov 18, 2018
package.json chore(release): 1.0.5 [skip ci] Nov 18, 2018
tsconfig.json Try to create the app from scratch on Microsoft App domain. Oct 30, 2018
tslint.json TSLint fixing. Nov 11, 2018
typedoc.json CI in progress. Nov 11, 2018
web.config web.config path updated. Apr 25, 2018

Area Status
Community Gitter Open-source PRs Welcome License
Management - Columns and their card count
Security Known Vulnerabilities
Building & Quality Build Status Coverage Status code style: prettier
Packaging forthebadge Dependencies Greenkeeper badge Commitizen friendly
Releases General Bots .gbapp lib semantic-release

Watch a video about packages, development environment and self-deployment

Now with General Bots you can press F5 on Visual Studio to get a bot factory on your environment published on November 10th, 2018.

General Bot Video

Welcome to General Bot Community Edition

General Bot Logo

General Bot is a package based chat bot server focused in convention over configuration and code-less approaches, which brings software packages and application server concepts to help parallel bot development. In this MSDN article you can have an overview of a General Bots application.

Checkout our FREE Intranet Quickstart Bot

What is a Bot Server?

General Bots Starting From Scrach

Bot Server accelerates the process of developing a bot. It provisions all code base, resources and deployment to the cloud, and gives you templates you can choose from whenever you need a new bot. The server has a database and service backend allowing you to further modify your bot package directly by downloading a zip file, editing and uploading it back to the server (deploying process) with no code. The Bot Server also provides a framework to develop bot packages in a more advanced fashion writing custom code in editors like Visual Studio Code, Atom or Brackets.

Everyone can create bots by just copying and pasting some files and using their favorite tools like Excel (or any text editor) or Photoshop (or any image editor).

Package Quick Reference

Whatsapp Web Core KB
whatsapp.gblib default.gbui core.gbapp kb.gbapp

General Bot Logo

The same build process for everyone

General Bots Block Architecture

GeneralBots aims to delivery bots in azure in a very easy and fast fashion. Use Office tools like Word or Excel to edit your Bot - using code (JavaScript or TypeScript) just to empower custom requirements.

Use Excel for (Hierarchical) Knowledge Base Editing

General Bots Inside Excel can enable bot production the masses

Use Visual Studio for a complete .gbai package building system

General Bots Inside Visual Studio Code provides a complete artificial intelligence based conversational platform

How To

Run the server locally

  1. Install Node.js the current generation General Bot code execution platform;
  2. Open a Terminal on Linux and Mac or a Command Prompt window on Windows;
  3. Type npm install -g botserver and press ENTER;
  4. Type gbot to run the server core.


Configure the server to deploy specific directory

  1. Create/Edit the .env file and add the ADDITIONAL_DEPLOY_PATH key pointing to the .gbai local parent folder of .gbapp, .gbot, .gbtheme, .gbkb package directories.
  2. Specify STORAGE_SYNC to TRUE so database sync is run when the server is run.
  3. In case of Microsoft SQL Server add the following keys: STORAGE_SERVER, STORAGE_NAME, STORAGE_USERNAME, STORAGE_PASSWORD, STORAGE_DIALECT to mssql.


  • You can specify several bots separated by semicolon, the BotServer will serve all of them at once.

Setup development environment (Windows)

  1. [Optional] Install Chocolatey, a Windows Package Manager;
  2. Install git, a Software Configuration Management (SCM).;
  3. Install Node.js, a Runtime system. ( (suggested: LTS 8.x.x);
  4. Install Visual Studio Code, Brackets or Atom as an editor of your choice;
  5. Fork by visiting
  6. Clone the just forked repository by running git clone <your-forked-repository-url>/BotServer.git ;
  7. Run npm install -g typescript;
  8. Run npm install on Command Prompt or PowerShell on the General Bot source-code folder;
  9. Enter './packages/default.gbui' folder;
  10. Run npm install folled by npm run build (To build default Bot UI);
  11. Enter the On the downloaded folder (../..);
  12. Compile the bot server by tsc.
  13. Run the bot server by npm start.


  • Whenever you are ready to turn your open-source bot ideas in form of .gbapp (source-code) and artifacts like .gbkb, .gbtheme, .gbot or the .gbai full package read about performing Pull Requests (PR) and creating other public custom packages repositories of your own personal or organization General Bot Community Edition powered packages.

Running unit tests

  1. Enter the BotServer root folder.
  2. Run tests by npm test.

Just copy the source code to your machine

  1. [Download] the Zip file of (

Updating the Bot Knoledge Base (.gbkb folder)

The subjects.json file contains all information related to the subject tree and can be used to build the menu carrousel as well give a set of words to be used as subject catcher in the conversation. A hierarchy can be specified.

Creating a new Theme folder (.gbtheme folder)

A theme is composed of some CSS files and images. That set of files can change everything in the General Bot UI. Use them extensively before going to change the UI application itself (HTML & JS).

Package Types


Embraces all packages types (content, logic & conversation) into a pluggable bot directory. A sample .gbai is available.


The artificial intelligence extensions in form of pluggable apps. Dialogs, Services and all model related to data. A set of interactions, use cases, integrations in form of conversationals dialogs. The .gbapp adds the General Bot base library (botlib) for building Node.js TypeScript Apps packages.

Four components builds up a General Bot App:

  • dialogs
  • models
  • services
  • tests


All code contained in a dialog builds the flow to custom conversations in built-in and additional packages .


Models builds the foundation of data relationships in form of entities.


Services are a façade for bot back-end logic and other custom processing.


Tests try to automate code execution validation before crashing in production.


An expression of an artificial inteligence entity. A .gbot file defines all bots dependencies related to services and other resources.


A theme of a bot at a given time. CSS files & images that can compose all UI presentation and using it a branding can be done. A sample .gbtheme is available


A set of subjects that bot knows in a form of hierarchical menu-based QnA. A sample .gbkb is available.


Shared code that can be used across bot apps.


GeneralBots admin commands

General Bot can be controlled by the same chat window people talk to, so here is a list of admin commands related to deploying .gb* files.

Command Description
deployPackage Deploy a KB package. Usage deployPackage [package-name]. Then, you need to run rebuildIndex.
undeployPackage Undeploy a KB. Usage undeployPackage [package-name].
redeployPackage Undeploy and then deploys the KB. Usage redeployPackage [package-name]. Then, you need to run rebuildIndex.
setupSecurity Setup connection to user directories.

Discontinued commands:

Command Description Reason
rebuildIndex Rebuild Azure Search indexes, must be run after deployPackage or redeployPackage. Now it is called automatically

Credits & Inspiration

Powered by Microsoft BOT Framework and Azure.

General Bot Code Name is Guaribas, the name of a city in Brasil, state of Piaui. Roberto Mangabeira Unger: "No one should have to do work that can be done by a machine".


This project welcomes contributions and suggestions. See our Contribution Guidelines for more details.

Reporting Security Issues

Security issues and bugs should be reported privately, via email, to the Security team at You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message.

License & Warranty

General Bot Copyright (c) All rights reserved. Licensed under the AGPL-3.0.

According to our dual licensing model, this program can be used either under the terms of the GNU Affero General Public License, version 3, or under a proprietary license.

The texts of the GNU Affero General Public License with an additional permission and of our proprietary license can be found at and in the LICENSE file you have received along with this program.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

"General Bot" is a registered trademark of The licensing of the program under the AGPLv3 does not imply a trademark license. Therefore any rights, title and interest in our trademarks remain entirely with us.