Modal logo

CLI Reference

modal app modal config modal deploy modal environment modal launch modal nfs modal profile modal run modal secret modal serve modal setup modal shell modal token modal volume

API Reference

Introduction modal.App modal.Client modal.Cls modal.Cron modal.Dict modal.Error modal.Function modal.Image modal.Mount modal.NetworkFileSystem modal.Period modal.Proxy modal.Queue modal.Retries modal.Sandbox modal.Secret modal.SharedVolume modal.Stub modal.Volume modal.asgi_app modal.call_graph modal.create_package_mounts modal.gpu modal.method modal.runner modal.web_endpoint modal.wsgi_app modal.exception modal.config

modal serve

Run a web endpoint(s) associated with a Modal stub and hot-reload code.

Examples:

modal serve hello_world.py

Usage:

modal serve [OPTIONS] STUB_REF

Arguments:

  • STUB_REF: Path to a Python file with a stub. [required]

Options:

  • --timeout FLOAT
  • --env TEXT: Environment to interact with

If none is specified, Modal will use the default environment of your current profile (can also be specified via the environment variable MODAL_ENVIRONMENT). If neither is set, Modal will assume there is only one environment in the active workspace and use that one, or raise an error if there are multiple environments.

  • --help: Show this message and exit.