You can create an environment for your Renku session based on a environment file in a code repository.

This guide will walk you through what kinds of files you can use to define environments in RenkuLab, and how to create a code-based environment for your project.

What kinds of environment definitions are supported?

RenkuLab’s code-based environments currently supports creating Python environments. Support for more languages is coming soon!

<aside> <img src="/icons/info-alternate_blue.svg" alt="/icons/info-alternate_blue.svg" width="40px" />

Do you need to install R packages in your Renku session? See R.

</aside>

Defining a Python Environment

There are multiple ways you can define a python environment for your Renku session:

• Miniconda (environment.yml) (recommended)
• Pip (requirements.txt)
• Poetry (pyproject.toml)

See below for more details on how to use each of these systems.

<aside> <img src="/icons/thought-dialogue_blue.svg" alt="/icons/thought-dialogue_blue.svg" width="40px" />

If you’d like to learn more about the system Renku uses to create python environments, check out https://paketo.io/docs/howto/python/#use-a-package-manager.

</aside>

Miniconda (environment.yml) (recommended)

Include an environment.yml file or a package-list.txt file located at the root of the code repository.

• Here’s an example environment.yml:

Please note that miniconda can only be used at this time to create Python environments, not R environments.

Environments defined with one of these files will be created via miniconda. Configuring a version of miniconda is not supported.

Pip (requirements.txt)

Include a valid requirements.txt file at the root (top level) of your code repository. Renku will create an environment from this file using pip.