FAIR-Cells allows the user to interactively create a Docker image from a Jupyter Notebook.
Project description
FAIR-Cells
FAIR-Cells is a Jupyter Notebook extension that allows the user to interactively create a Docker image from a Jupyter Notebook. Our tool can be used to generate Docker images from single cells of a Jupyter Notebook. The generated image will run a web service that will output the specified cell. This includes image outputs like plots. Code introspection for Python enables the services to change cell output at service run-time.
Among other things, FAIR-Cells is useful for reusing notebook components in workflows that support web services.
... More information to follow ...
Installation
FAIR-Cells can be downloaded using pip. It then needs to be enabled using three Jupyter commands. Docker is required for the extension to have any effect.
$ [sudo] pip install jupyter --user
$ [sudo] pip install fair-cells --user
$ jupyter serverextension enable --py fair-cells --user
$ jupyter nbextension install --py fair-cells --user
$ jupyter nbextension enable fair-cells --user --py
Run with Docker
docker run -it -p 8888:8888 -e GEN_CERT=yes -v /var/run/docker.sock:/var/run/docker.sock qcdis/fair-cells
Development
To keep your system clean it is recommended to develop using Docker. The following command will run a Jupyter Notebook server with FAIR-Cells enabled at http://localhost:8888. Autoreload is enabled for Python files, you will need to reload your browser to see changes in the front-end.
$ docker-compose up --build main
To test the helper server that runs inside of the container run the following command. This uses a dummy notebook that
can be found in docker/helper_dummy
. The notebook will be available at http://localhost:10000
$ docker-compose up --build helper
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for FAIR_Cells-1.0.13-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c6c74a05762b394c997a74bf2556c790fa696a06cca9eadd59c264684e3a44c4 |
|
MD5 | d6a954782e63432a1e27cdd4f1053341 |
|
BLAKE2b-256 | d94e960955a42d1f05bb1e70b545a9fe136f6fa5266f5442ec0ef84c2719ba91 |