Functions Framework for Python is an open-source FaaS (Function as a Service) framework designed for writing portable Python functions. It allows developers to test their Google Cloud Functions locally, run them in other serverless environments, or deploy them directly to Google Cloud. The current version is 3.10.1, and it maintains an active release cadence with frequent patch and minor updates, typically every 1-3 months.
Install & Compatibility
Where this runs
tested against v3.10.1 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.930 runs
installs and imports cleanly · install 0.0s · import 0.480s · 30.4MB
glibcpy 3.10–3.930 runs
installs and imports cleanly · install 3.4s · import 0.437s · 31MB
29MB installed
● package 29MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
For HTTP functions, the primary input argument is a Flask Request object. No direct import of `functions_framework` is typically needed in your function code.
from flask import Request
For CloudEvent functions, the primary input argument is a CloudEvent object. No direct import of `functions_framework` is typically needed in your function code.
from cloudevents.http import CloudEvent
Define an HTTP function `hello_http` in a file (e.g., `main.py`). The function receives a `flask.Request` object. Run it locally using the `functions-framework` CLI, specifying the function name with `--target`. By default, it runs on port 8080.
# main.py
def hello_http(request):
"""Responds to any HTTP request.
Args:
request (flask.Request): The request object.
Returns:
The response text, or any set of values that can be turned into a Response object
using `make_response`.
"""
request_json = request.get_json(silent=True)
request_args = request.args
if request_json and 'name' in request_json:
name = request_json['name']
elif request_args and 'name' in request_args:
name = request_args['name']
else:
name = 'World'
return f'Hello {name}!'
# To run locally:
# 1. Save this as main.py
# 2. Run from your terminal: functions-framework --target hello_http
# 3. Access at http://localhost:8080/
functions-framework --version
Upgrade
Version history
Breaking-change detection hasn't run for this library yet.
Audit
Security & dependencies
CVE tracking and dependency tree are planned for a later release.