🚸 Improve documentation to avoid problems installing laminr

[falexwolf]

I'm pasting from an internal Slack discussion with @SHerresthal so that you're aware @lazappi & @rcannood and can potentially improve docs & installation process.

The error that Steffi ran into manifested as:

library(laminr)
laminr:::install_lamindb()
Error: Tools for managing Python virtual environments are not installed.
Install venv with:
$ sudo apt-get install python3-venv

This was her Docker

FROM lorenzobonaguro/cycondor:v020
USER root
RUN R -e "install.packages('remotes', repos = 'http://cran.us.r-project.org/')"
RUN R -e "remotes::install_github('laminlabs/laminr', dependencies = TRUE)"
RUN apt-get update && apt-get install -y python3-venv

She installed from GitHub

I installed laminr directly from Github because the installation from CRAN does not have all the functions exported in the Namespace, which gave me an error. But from Github it worked.

The resolution was this:

The problem was that there were different versions of python installed, but when I first installed lamindb into the right environment and then used that environment with laminr:::install_lamindb(new_env = TRUE) , it worked

[falexwolf]

Adding the section would also close this issue:

• docs: add section to make sure reticulate uses a supported python version #128

I'd say making a CRAN release and adding these docs improvements are the key priorities for the start of the year.

[lazappi]

library(laminr)
laminr:::install_lamindb()
Error: Tools for managing Python virtual environments are not installed.
Install venv with:
$ sudo apt-get install python3-venv

I think this error is because {reticulate} can't find venv. Exactly why this is I'm not sure as it looks like it was installed in your docker.

The problem was that there were different versions of python installed, but when I first installed lamindb into the right environment and then used that environment with laminr:::install_lamindb(new_env = TRUE) , it worked

I'm not quite sure what the solution was here. @SHerresthal could you please explain a bit more what you did to get it working? install_lamindb() should handle creating an environment for you (if it can find venv and/or conda).