Modal Python Library

The Modal Python library provides convenient, on-demand access to serverless cloud compute from Python scripts on your local computer.

Documentation

This library requires Python 3.9 – 3.13.

Install the package with pip:

pip install modal

You can create a Modal account (or link your existing one) directly on the command line:

python3 -m modal setup

For usage questions and other support, please reach out on the Modal Slack.

Name	Name	Last commit message	Last commit date
Latest commit github-actions[bot] [auto-commit] [skip ci] Bump the build number Mar 27, 2025 d007e67 · Mar 27, 2025 History 6,703 Commits
.github	.github	fix pypi release (take 3) (#2977 )	Mar 25, 2025
.vscode	.vscode	Add vscode config for client tests (#2405 )	Oct 25, 2024
modal	modal	Revert #2958 (#2983 )	Mar 27, 2025
modal_docs	modal_docs	Fix docs for objects defined in submodules (#2901 )	Feb 25, 2025
modal_global_objects	modal_global_objects	Add base images for notebooks (#2963 )	Mar 20, 2025
modal_proto	modal_proto	Revert #2958 (#2983 )	Mar 27, 2025
modal_version	modal_version	[auto-commit] [skip ci] Bump the build number	Mar 27, 2025
protoc_plugin	protoc_plugin	Run pyupgrade for Py3.9+ (#2591 )	Nov 30, 2024
test	test	Revert #2958 (#2983 )	Mar 27, 2025
.gitignore	.gitignore	MOD-2454: remove aiostream dependency: async_zip (#2341 )	Oct 16, 2024
.pre-commit-config.yaml	.pre-commit-config.yaml	Update from ruff v0.2.1 to ruff v0.9.6 (#2854 )	Feb 10, 2025
CHANGELOG.md	CHANGELOG.md	Get releases working again (#2984 )	Mar 27, 2025
LICENSE	LICENSE	remove license appendix (#54 )	Nov 8, 2022
README.md	README.md	Drop support for Python 3.8 (#2500 )	Nov 15, 2024
conftest.py	conftest.py	Markdown test modal "Runnable" (#2948 )	Mar 14, 2025
pyproject.toml	pyproject.toml	fix pypi release (take 3) (#2977 )	Mar 25, 2025
requirements.dev.txt	requirements.dev.txt	Markdown test modal "Runnable" (#2948 )	Mar 14, 2025
tasks.py	tasks.py	Add base images to invoke (#2961 )	Mar 20, 2025