Metadata-Version: 2.1
Name: jupyterlab-workbench
Version: 0.1.2
Summary: UNKNOWN
Home-page: https://github.com/enlznep/pyexample
Author: Ray Marc Marcellones (XTREME-D Inc)
Author-email: devops@xtreme-d.net
License: GPLv3+
Platform: UNKNOWN
Classifier: Framework :: Jupyter :: JupyterLab :: 3
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Healthcare Industry
Classifier: Intended Audience :: Manufacturing
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: AUTHORS

# JupyterLab Workbench

JupyterLab Workbench is an opensource software with pre-installed JupyterLab and essential packages intended for corporations, researchers, scientists, students, educators, and etc.

List of pre-installed packages:
- Pillow
- Bash Kernel
- IPython
- IPyWidgets
- Jupyter LDAP Authenticator
- MGLearn
- Numpy
- Pandas
- Scikit-learn
- SciPy
- ...more
---

## Installation ##

You can install it from pip with:
```
pip install jupyterlab-workbench
```
---
## Usage ##

First, we need to build it
```
jlwb build
```

Generate a `jupyterhub_config.py` file
```
jlwb generate_config
```

Start the JupyterLab-Workbench
```
jlwb start -f <path/to/generated_config>
```

For more information
```
jlwb help
```
---
## Deploy ##
Edit the generated config file and uncomment the block
```
c.JupyterHub.spawner_class = 'systemdspawner.SystemdSpawner'
c.SystemdSpawner.default_shell = '/bin/bash'
c.SystemdSpawner.unit_extra_properties = {'LimitMEMLOCK': 'infinity'}
```

Create a systemd environment file: `jlwb.env`
```
PATH=$PATH:/path/to/env/bin
AUTH_TYPE=''
LDAP_SERVER_HOST=''
LDAP_BIND_USER_DN=''
LDAP_BIND_USER_PASSWORD=''
LDAP_USER_SEARCH_BASE=''
LDAP_USER_SEARCH_FILTER=''
```

Create a systemd service file: `jlwb.service`
```
[Unit]
Description=JupyterLab Workbench
After=syslog.target network.target

[Service]
User=root
EnvironmentFile=/path/to/jlwb.env
StandardOutput=file:/path/to/log/jlwb.sysout.log
ExecStart=/path/to/env/bin/jlwb start -f /path/to/jupyterhub_config.py

Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target
```
Start JupyterLab Workbench
```
systemctl daemon-reload
systemctl start jlwb.service
systemctl enable jlwb.service
systemctl status jlwb.service
```
---
## Development ##

Clone the project
```
git clone git@github.com:enlznep/jupyterlab-workbench.git
```

Create a virtualenv
```
python -m virtualenv env
source env/bin/activate
```

Install the package
```
pip install .
```


