Skip to content

alexbunardzic/aiva

 
 

Repository files navigation

AIVA GitHub version Build Status Coverage Status Dependency Status MIT licensed <iframe src="https://ghbtns.com/github-btn.html?user=kengz&repo=aiva&type=star&count=true" frameborder="0" scrolling="0" width="170px" height="20px"></iframe>

AIVA (A.I. Virtual Assistant): General-purpose virtual assistant for developers.

It is a bot-generalization: you can implement any features, use with major AI tools, deploy across platforms, and code in multiple languages.

AIVA is Details
general-purpose An app interface, AI assistant, anything!
cross-platform Deploy simultaneously on Slack, Telegram, Facebook, or any hubot adapters
multi-language Code in and coordinate among Node.js, Python, Ruby, etc.
built-in with AI tools Tensorflow, SkFlow, Scikit, Pandas, Indico.ml, spaCy, Watson, Google APIs
hackable It extends Hubot. Add your own modules!
powerful, easy to use Check out setup and features

To see what they mean, say you have a todo-list feature for AIVA, written in Node.js and leverages NLP and ML from Python. Set your todo list earlier from Slack on desktop? You can access it from Telegram or Facebook on mobile.

We see people spending a lot of time building bots instead of focusing on what they want to do. It still requires much effort to just get a bot up and running. Moreover, the bot built is often confined to a single language, single platform, and without AI capabilities.

Why restrict when you can have all of it? Why build multiple bots when you can have one that plugs into all platforms and runs all languages?

AIVA exists to help with that - we do the heavy-lifting and build a ready-to-use bot; it is general purpose, multi-language, cross-platform, with robust design and tests, to suite your needs.

AIVA gives you powerful bot tools, saves you the time to build from scratch, and allows you to focus on what you want to do. Morever, you can build once, run everywhere with AIVA's multi-adapter (Slack, Telegram, Fb).

Installation

1. Fork this repo so you can pull the new releases later:

    <iframe src="https://ghbtns.com/github-btn.html?user=kengz&repo=aiva&type=fork&count=true" frameborder="0" scrolling="0" width="170px" height="20px"></iframe>

2. Clone your forked repository:

git clone https://github.com/YOURUSERNAME/aiva.git

Setup, Run

You can run AIVA on your local machine or a Ubuntu server - Digital Ocean recommended. See Docker installation if you're new to it, or the alternate setups.

docker pull kengz/aiva
  • setup keys: update .env, bin/.key-aiva (production), bin/.key-aivadev (development).
On Mac OSX, before using Docker, make sure there's a default docker machine running: docker-machine start default.

Run

  • run:
npm start # runs aivadev

See Commands for more. This will start AIVA with the default hubot adapters: Slack, Telegram, Facebook. See Adapters for connecting to different chat platforms.

AIVA saying hi, translating, running deep neural net; on Slack, Telegram, Facebook:

AIVA on Slack, Telegram

Check Setup tips for help.

Legacy Releases

AIVA was known as Jarvis in version 2. It is now deprecated, but if you need to reference stuff from Jarvis, do git checkout tags/v2.0 or checkout the releases.

Contributing

We'd love for you to contribute and make AIVA even better for all developers. We're mainly interested in something generic and foundational, e.g. adding client for a new language, improving the NLP, adding a useful generic module, adding more adapters like Skype or Twilio.

About

AIVA (A.I. Virtual Assistant): General-purpose virtual assistant for developers.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 51.6%
  • Python 17.6%
  • CoffeeScript 16.5%
  • Shell 11.6%
  • Nginx 1.4%
  • Ruby 1.3%