Skip to content

servo-ai/servo-platform

Repository files navigation

Servo.ai

Servo Bot Automation Framework is the leading framework for building bots and automation flows. It allows developers to use visual architecture, open code and reusable AI.
Click to watch a short intro video:
Servo]

Installation

  1. install nodejs (v8 and higher) and npm (v5.5 and above)
  2. clone and install:
    • sudo npm install -g gulp bower concurrently
    • git clone https://github.com/servo-ai/servo-platform.git
    • cd servo-platform/server
    • optional:
      ** Windows: npm install --global --production windows-build-tools
      ** Linux: sudo apt-get install build-essential libssl-dev
    • npm install
    • cd ../editor
    • npm install
    • bower install

If you get errors during npm install, then: * on windows: npm install --global --production windows-build-tools * linux: sudo apt-get install build-essential libssl-dev

Run Servo

From server folder:
npm start

On Chrome browser open localhost:8000.

Please note: Servo comes with a couple of tutorial projects, that will connect to Wit.ai NLU engine.

Tutorials

To get started, see the wiki: https://github.com/servo-ai/servo-platform/wiki

For reference documentation, see https://servo-ai.github.io/servo-platform/


Build documentation

  • cd server
  • jsdoc ./ -r -c ./jsdoc-config.json -d ../docs -t ./ink-docstrap/template -R ./README.md
  • npm run cpdoc

Optional/advanced installations:

Terminals

Servo uses two apps, one for the server and one for the editor. npm start will run them both on the same terminal. you can, however, run them in two separate terminals:

  • cd server && node app.js
  • cd editor && gulp serve

Database:

couchbase

  • install couchbase
  • restore from release-proc/couchbase-buckets
  • change db entry at src/server/config.json to 'couchdb'

mongodb

  • install mongodb
  • change db entry at src/server/config.json to 'mongo'

Certificates:

  1. get a new domain

  2. Install a certificate

  • all certificates should be put under a server/certificates/ folder, with following names: **cert.pem **chain.pem **privkey.pem

  • change entries at server/config.json: "serverBaseDomain": "<domain>", "openSSL": true,