Using virtualenv

From Yocto Project
Jump to navigationJump to search


Toaster brings in extra Python dependencies that the Bitbake core doesn't need in order to run. As such, it is expected that some Python packages required by Toaster may not be installed on the systems that currently run Bitbake without issues.

In order to make it easy to run Toaster, a requirements file is provided; this file, named "toaster-requirements.txt", in the root directory of bitbake, lists dependencies in a pip install-compatible format.

The recommend usage is to install these dependencies in a Python virtual environment using pip.

How to

1. create a virtual environment and activate it:

$ virtualenv venv
$ source venv/bin/activate

2. use pip to install needed packages

$ pip install -r bitbake/toaster-requirements.txt


3. use toaster normally, either in

  • interactive mode
$ source oe-init-build-env
$ source toaster start
  • managed mode
$ bitbake/bin/toaster


Happy virtualenv-ing !