Everware is about re-useable science, it allows people to jump right in to your research code.
It lets you launch Jupyter notebooks from a git repository with a click of a button. Everware is an extension for JupyterHub. The main component is a spawner that allows you to spawn custom docker images.
Checkout the ROADMAP to see where we are going and how to get involved with the project.
See this blog
for more information about what
everware is and how it can be useful.
We have some documentation on the different ways to use
Try it out
In order to deploy your own
everware instance, you have to:
- create and activate a
condaenvironment with python 3.5(or 3.6.0)
conda create -n everware python=3.5 source activate everware
- Clone this repo and install
git clone https://github.com/everware/everware cd everware make install
Create a Github OAuth application with URL
http://localhost:8000/and callback URL
Enter you OAuth information into
source env.sh. You will have to set these environment variables every time before running
If you are on Mac OS make sure the VM in which docker runs is started (
docker-machine start <vm-name>) and your environment is setup properly (
docker-machine env <vm-name>). Start
everware-server -f etc/local_dockermachine_config.py --debug --no-ssl
- If you are on Linux make sure
dockerdis running, your user is in docker group and your environment contains the required information (
DOCKER_HOSTis set, etc). Then start
everware-server -f etc/local_config.py --debug --no-ssl
Everware can also be deployed in a Docker container. See Everware in Docker container
brew install selenium-server-standalone
Note: if you are not starting from an environment that already contains
dockerspawner make sure it is updated to the right commit.
be satisfied if it is installed which might leave you with an old version.
Paper (2017-02): https://arxiv.org/abs/1703.01200