Skip to content

Additional Applications Setup

Info

Issue: https://gitlab.com/pipettin-bot/pipettin-bot/-/issues/90

Additional apps

A few useful applications can be installed on the robot's computer, which may help with development or general usage.

Jupyter Lab

This is one of the best ways to operate the robot programatically.

Note

We are working on integrating pipettin with PLR, which is a hardware-agnostic python API for liquid handling robots.

Jupyter can be installed and setup with pip:

sudo -H pip3 install notebook jupyterhub
jupyterhub --generate-config
sudo mv jupyterhub_config.py /root
sudo systemctl start jupyterhub.service
sudo systemctl enable jupyterhub.service 
sudo systemctl status jupyterhub.service

Make sure that the systemd unit file looks something like this:

[Unit] 
Description=JupyterHub Service 
After=multi-user.target  
[Service] 
User=root 
ExecStart=/usr/local/bin/jupyterhub --config=/root/jupyterhub_config.py 
Restart=on-failure  
[Install] 
WantedBy=multi-user.target

The output of the sudo systemctl status jupyterhub.service command will show the port (e.g. --port 8000) and the config file in use (e.g. --config=/root/jupyterhub_config.py).

You may need to allow connections from IPs other then the local-host, by editing Jupyter's config. Our config was found at /root/jupyterhub_config.py. See https://stackoverflow.com/a/43500232 for details.

Try connecting to the Pi's IP at port 8000.

There is also a custom systemd unit you can use instead: jupyter.service

It is meant to be placed at /etc/systemd/system/jupyter.service. If you want to use it, you'll also need to run:

sudo cp jupyter.service /etc/systemd/system/jupyter.service
sudo systemctl daemon-reload
sudo systemctl start jupyter.service
sudo systemctl status jupyter.service
sudo systemctl enable jupyter.service

MkDocs docs

Warning

TO-DO: write a systemd unit to start the mkdocs site at boot.

GitBuilding docs

Warning

This is deprecated but left here for future reference.

Unit file: gitbuilding.service

Requirements:

sudo cp gitbuilding.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl start gitbuilding.service
sudo systemctl status gitbuilding.service
sudo systemctl enable gitbuilding.service