Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Run AWS Lambda functions locally

Project Description

run_lambda is a Python package for running Python AWS Lambda functions locally. It offers a Python module for automated testing of Lambda functions, as well as a command-line interface for ad-hoc local invocations.

Doesn’t something like this already exist?

Not exactly. There are other programs for locally running Python Lambda functions. However, all of the other utilities (that I know of) only provide a command-line tool. A command-line tool is great for quick manual invocations. However, if you want to create robust, automated tests for your Lambda functions, a Python module that you can import and call is more appropriate. run_lambda is unique because it offers both a simple command-line tool for manual invocations, and an importable Python module for automated tests.


run_lambda supports

  • An interface for examining the result (return value, exception, timeout) of a function call
  • A full implementation of AWS Context objects
  • Function calls with or without a timeout
  • Resource usage profiling (memory and run-time)
  • Convenient mocking of objects and services inside Lambda functions


The easiest way to install is via pip:

$ pip install run_lambda

You can also download the source from Github.


Documentation for the package can be found on Read the Docs.

Release History

Release History

This version
History Node

History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
run_lambda- (14.8 kB) Copy SHA256 Checksum SHA256 py2 Wheel Sep 10, 2017
run_lambda- (14.8 kB) Copy SHA256 Checksum SHA256 py3 Wheel Sep 10, 2017
run_lambda- (10.2 kB) Copy SHA256 Checksum SHA256 Source Sep 10, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting