modal run

Run a Modal function or local entrypoint.

FUNC_REF should be of the format {file or module}::{function name}. Alternatively, you can refer to the function via the stub:

{file or module}::{stub variable name}.{function name}


To run the hello_world function (or local entrypoint) in

modal run

If your module only has a single stub called stub and your stub has a single local entrypoint (or single function), you can omit the stub and function parts:

modal run

Instead of pointing to a file, you can also use the Python module path:

modal run my_project.my_app


modal run [OPTIONS] FUNC_REF


  • -q, --quiet: Don’t show Modal progress indicators.
  • -d, --detach: Don’t stop the app if the local process dies or disconnects.
  • -i, --interactive: Run the app in interactive mode.
  • -e, --env TEXT: Environment to interact with.

If not specified, Modal will use the default environment of your current profile, or the MODAL_ENVIRONMENT variable. Otherwise, raises an error if the workspace has multiple environments.

  • --help: Show this message and exit.