aws-wsgi

What it is and what it does

aws-wsgi is a bridge that lets you run WSGI web applications inside AWS Lambda functions triggered by API Gateway. It translates the event and context objects that Lambda receives into standard WSGI request/response pairs, allowing existing web framework code to work without modification in a serverless environment.

The package has been abandoned since 2020-07-07 and its repository is archived. It declares support only for Python 2.7, 3.3, 3.4, and 3.5, all end-of-life versions. While it may still work on modern Python versions, there are no guarantees, and no one is maintaining it to handle breaking changes in AWS Lambda runtimes or API Gateway behavior.

Use it for:

• Maintain legacy code already using this package without rewriting Lambda handlers.
• Prototype serverless applications using familiar WSGI patterns when refactoring is not immediately feasible.
• Handle binary responses from WSGI applications on Lambda by specifying base64_content_types.
• Run existing WSGI applications on Lambda with minimal code changes during migration.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Adapts WSGI-compatible Python web frameworks to run as AWS Lambda functions behind API Gateway's proxy integration.

No, unless you are maintaining legacy code already using this package. The project is abandoned (last release 2020-07-07, repository archived), declares support only for end-of-life Python versions, and receives no security or compatibility updates. For new projects, use a maintained alternative or write Lambda handlers directly. If you must use it, verify compatibility with your Python version and AWS Lambda runtime before deploying.

Install

aws-wsgi on PyPI

pip install aws-wsgi

uv add aws-wsgi

poetry add aws-wsgi

Installing aws-wsgi

Before you install

Installation is straightforward with no runtime dependencies. However, the package is abandoned—the repository is archived and the last commit was 2024-03-13, with no releases since 2020-07-07. Maintenance has ceased, so security patches or compatibility fixes are unlikely.

License in practice

Licensed under MIT (permissive), so you can use, modify, and distribute it freely with minimal restrictions.

Quickstart

pip install aws-wsgi

import awsgi

def lambda_handler(event, context):
    return awsgi.response(app, event, context, base64_content_types={"image/png"})

Requires AWS Lambda environment with API Gateway proxy integration configured; declares support only for Python 2.7, 3.3, 3.4, and 3.5, all end-of-life versions.

Verify before relying

• Compatibility with modern Python versions (3.10+) and current AWS Lambda runtime versions
• Whether the package works with recent versions of WSGI frameworks or only legacy versions
• Active community forks or maintained alternatives that supersede this archived project

Package facts

Evidence: aws_wsgi-0.2.7-py2.py3-none-any.whl

Keywords: wsgi, aws, lambda, api, gateway

Tags

More HTTP Servers packages