Mangum

Mangum is an adapter for running ASGI applications in AWS Lambda to handle Function URL, API Gateway, ALB, and Lambda@Edge events.

Documentation: https://mangum.fastapiexpert.com/

Features

Event handlers for API Gateway HTTP and REST APIs, Application Load Balancer, Function URLs, and CloudFront Lambda@Edge.
Compatibility with ASGI application frameworks, such as Starlette, FastAPI, Quart and Django.
Support for binary media types and payload compression in API Gateway using GZip or Brotli.
Works with existing deployment and configuration tools, including Serverless Framework and AWS SAM.
Startup and shutdown lifespan events.

Installation

pip install mangum

Example

from mangum import Mangum

async def app(scope, receive, send):
    await send(
        {
            "type": "http.response.start",
            "status": 200,
            "headers": [[b"content-type", b"text/plain; charset=utf-8"]],
        }
    )
    await send({"type": "http.response.body", "body": b"Hello, world!"})


handler = Mangum(app, lifespan="off")

Or using a framework:

from fastapi import FastAPI
from mangum import Mangum

app = FastAPI()


@app.get("/")
def read_root():
    return {"Hello": "World"}


@app.get("/items/{item_id}")
def read_item(item_id: int, q: str = None):
    return {"item_id": item_id, "q": q}

handler = Mangum(app, lifespan="off")

Download files

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

Source Distribution

mangum-0.22.0.tar.gz (118.3 kB view details)

Uploaded Aug 22, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

mangum-0.22.0-py3-none-any.whl (17.1 kB view details)

Uploaded Aug 22, 2026 Python 3

File details

Details for the file mangum-0.22.0.tar.gz.

File metadata

Download URL: mangum-0.22.0.tar.gz
Upload date: Aug 22, 2026
Size: 118.3 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for mangum-0.22.0.tar.gz
Algorithm	Hash digest
SHA256	`701936891aaed8ed66479b871c2bda87ba288fd01c7d5dd6ba6c8e9ba1c239d1`
MD5	`aafee6cd726190c201b63db89f077c16`
BLAKE2b-256	`82c81579c705908d02a4526a748e8d0f0419151d4498c59033840f5df3a14822`

See more details on using hashes here.

Provenance

The following attestation bundles were made for mangum-0.22.0.tar.gz:

Publisher: publish.yml on Kludex/mangum

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: mangum-0.22.0.tar.gz
- Subject digest: 701936891aaed8ed66479b871c2bda87ba288fd01c7d5dd6ba6c8e9ba1c239d1
- Sigstore transparency entry: 2564886339
- Sigstore integration time: Aug 22, 2026
Source repository:
- Permalink: Kludex/mangum@042ac4442060f4634ff161a1a40816f4aeec242e
- Branch / Tag: refs/tags/0.22.0
- Owner: https://github.com/Kludex
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@042ac4442060f4634ff161a1a40816f4aeec242e
- Trigger Event: push