__init__ ​

v1 syntax

base ​

def base(image: str = "ubuntu:20.04", dev: bool = False)

Set up the base env.

Arguments:

• image str - docker image, can be any Debian-based image
• dev bool - enabling the dev env will add lots of development related libraries like envd-sshd, vim, git, shell prompt, vscode extensions, etc.

shell ​

def shell(name: str = "bash")

Interactive shell

Arguments:

• name str - shell name (i.e. zsh, bash)

run ​

def run(commands: List[str], mount_host: bool = False)

Execute command

Arguments:

• commands List[str] - command to run during the building process
• mount_host bool - mount the host directory. Default is False. Enabling this will disable the build cache for this operation.

Example:

run(commands=["conda install -y -c conda-forge exa"])

git_config ​

def git_config(name: Optional[str] = None,
               email: Optional[str] = None,
               editor: Optional[str] = None)

Setup git config.

Arguments:

• name str - User name

• email str - User email

• editor str - Editor for git operations

  Example usage:

git_config(name="My Name", email="my@email.com", editor="vim")

include ​

def include(git: str)

Import from another git repo

This will pull the git repo and execute all the envd files. The return value will be a module contains all the variables/functions defined (except the ones with _ prefix).

Arguments:

• git str - git URL

  Example usage:

envd = include("https://github.com/tensorchord/envdlib")

def build():
    base(os="ubuntu20.04", language="python")
    envd.tensorboard(host_port=8000)