Welcome to the bip.io API Server (Sansa 0.3)
bip.io is Billion Instructions Per I/O - For People and Robots.
Imagine you can send a single standard payload and have a limitless host of API's orchestrate at your command.
That's what bip.io does.
Follow @bipioapp on Twitter for regular news and updates, or /join #bipio
on Freenode IRC
bip.io is a nodejs based web automation framework that runs 'bips'. A Bip is a web automation agent. A Bip can connect many different web services and perform useful work. It can act on your behalf or perform at your command.
Bips can take actions in sequence or in parallel, and chain web services together as you like. They can be put to work via Web Hooks, Email or Trigger when something happens.
bip.io can be installed alongside your existing open source app or prototype for out-of-band message transformation, feed aggregation, queuing, social network fanout or whatever you like, even on your Rasberry Pi.
This server software is a RESTful JSON API supporting account level namespacing and multiple domains (fqdn) per account. Clients authenticate over HTTP Basic.
bip.io is dynamic, flexible, fast, modular, opinionless and GPLv3 open source.
Find out more in the wiki.
Pods are the standalone service containers bip.io uses to encapsulate and standardize the world's API's. Supported Services are growing fast, and open source.
This server ships with a few handy 'Pods' which you can use right away - Email, Text/HTML/Markdown Templating, Flow Control, Syndication, Web Hooks and Time.
Extra Pods can be found in the master repository.
To install a pod :
npm install bip-pod-{pod-name}
./tools/pod-install.js -a {pod-name}
And follow the instructions.
Feel free to craft your own.
The bip.io server is a light weight headless API server and ships without a User Interface (UI). The official UI can be found on the bip.io hosted platform. It's completely free.
Sign in to bip.io to mount your local install from your browser under My Account > Mounts > Create Mount.
Be sure to answer 'yes' to the SSL question during setup to install a self signed SSL certificate. This will avoid any browser security restrictions when mounting your server via the hosted website. You must visit your bipio server in a browser first and accept the self signed certificate, or the mount may not work eg : https://localhost:5000/status
The UI is a thin client which is loaded entirely into your browser. Once loaded you can reach any bipio server your browser can connect to such as from behind any firewall, over VPN or IP tunnel etc.
- Node.js >= 0.10.15 API and graph resolver
- MongoDB Server v2.6 data store
- RabbitMQ message broker
SMTP Bips are available out of the box with a Haraka plugin. Configs under bipio-contrib/haraka.
sudo npm install -g bipio
bipio
sudo npm install bipio
cd node_modules
npm start
git clone git@github.com:bipio-server/bipio.git
cd bipio
npm install
node . (or `npm start`)
When setting bip.io up for the first time, the install process will enter interactive mode, saving to the path of NODE_CONFIG_DIR environment variable,if set (otherwise, just config/{environment.json}.
export NODE_CONFIG_DIR=<path_to_your_config_directory>
Be sure to have a MongoDB server and Rabbit broker ready and available before install. Otherwise, follow the prompts during the install process to get a basically sane server running that you can play with.
For Ubuntu users, a sample upstart script is supplied in config/upstart_bip.conf which should be copied to /etc/init and reconfigured to suit your environment.
If you have a more complex deployment environment and the packaged sparse config doesn't suit, don't worry! Set the environment variable BIPIO_SPARSE_CONFIG to the path of your preferred config file, and it will use that instead.
For a non-interactive setup (ie: make install without any user interaction) - set environment variable HEADLESS=true
bip.io does not provide any load balancing beyond node-cluster. It can provide SSL termination but this is unsuitable for a production environment. If you need SSL termination this should ideally be delegated to the forward proxy of your choice such as Nginx, Apache, HAProxy etc.
A healthy contributor community is great for everyone! Take a look at the Contribution Document to see how to get your changes merged in.
Please log issues to the repository issue tracker on GitHub.
Our open source license is the appropriate option if you are creating an open source application under a license compatible with the GNU GPLv3.
If you'd like to integrate bip.io with your proprietary system, GPLv3 is likely incompatible. To secure a Commercial OEM License, please reach us