Basically you’re able to install the lambda-toolkit using pip. You can also install it manually, cloning the project from GitHub.


If you’re not a developer and you’re not planning to contribute developing in lambda-toolkit, we do recommend to use pip installation mode..

General Prerequisites

Basically, to start to use the lambda-toolkit, you must have at least:

  • Python 2 or 3
  • Package Management System (pip)
  • AWS Credentials


Python is required to use lambda-toolkit. By this way, you should make sure that your system has a proper Python installation available:

$ python --version
Python x.x.x

If your system does not support Python, you can install here.

Package Management System (pip)

pip is required to use lambda-toolkit. By this way, you should make sure that your system has a proper pip installed:

$ pip --version
pip 9.0.1 from /Library/Python/2.7/site-packages/pip-9.0.1-py2.7.egg (python 2.7)

If you system does not has pip installed, you can install here.

AWS Credentials

Lambda-toolkit can read yours credentials from the system environment variables or credential files.

If you’re already using aws cli for example, credential files were generated when the command aws configure was executed.


Lambda-toolkit tries first to read the environment variables, and if it is not configured, lambda-toolkit reads the credential files.


We do recommend to use credential files.

Using credential files

Make sure that you have the files:

  • ~/.aws/credentials
  • ~/.aws/config

For example:


aws_access_key_id = AAAAAAAAAAAAAAAAAAAA
aws_secret_access_key = AWS_ACCESS_SECRET_KEY__KEEP_IT_SAFE


region = eu-west-1


As you can see, the example shows how to create a default credential. You can create others, and then, you can use the environment variable AWS_PROFILE to choice a specific one. You can also overwrite your region option, setting the environment variable AWS_REGION.

Using environments variables

Specify the env variables below:


For example:

$ export AWS_REGION="us-east-1"


Remember that you must export the variables.


Lambda-toolkit only uses the environment variables, if the 3 variables are available.


Installing using pip

The installation with pip is quick and simple. For common installation, use the command below:

$ sudo -H pip install lambda-toolkit
$ lt --help


If you want uninstall lambda-toolkit, just run sudo pip uninstall lambda-toolkit. To update, run sudo pip install lambda-toolkit -U

Cloning the repository manually

Installing from repository is not to common users, but it is also another option. To install from repository you also need to have the git client installed.

The first step is clone the repository:

$ git clone

Install the requirements using pip:

$ pip install -r lambda-toolkit/requirements-user.txt
$ lambda-toolkit/bin/lt --help

And then, you are able to run the lambda-toolkit from current user: