Brickrefs are used to reference a brick for installation, removal, and loading. Currently, brickrefs can either be an alphanumeric name eg. “tox21”, or they can be a git remote with commit eg. “”.

Future refs may allow references to branches, tags, and releases.


The BBLIB is set for a user by running biobricks configure. It is a path to a filesystem for storing data assets. It is a good idea to choose a path that has a lot of free space and fast read times. A mounted SSD is a good choice.

TOKEN provides a temporary token for testing on install. To receive a permanent token register on and go to to generate a token. Biobricks uses this token to track brick usage, provide support, and generate usage based billing.