NAME

       papermill - papermill

SYNOPSIS

       papermill [OPTIONS] NOTEBOOK_PATH [OUTPUT_PATH]

DESCRIPTION

              This utility executes a single notebook in a subprocess.

              Papermill  takes  a  source  notebook,  applies  parameters  to  the source notebook, executes the
              notebook with the specified kernel, and saves the output in the destination notebook.

              The NOTEBOOK_PATH and OUTPUT_PATH can now be replaced by `-` representing stdout and stderr, or by
              the presence of pipe inputs / outputs. Meaning that

              `<generate input>... | papermill | ...<process output>`

              with `papermill - -` being implied by the pipes will read a notebook from stdin and write  it  out
              to stdout.

OPTIONS

       --help-notebook
              Display parameters information for the given notebook path.

       -p, --parameters TEXT...
              Parameters to pass to the parameters cell.

       -r, --parameters_raw TEXT...
              Parameters to be read as raw string.

       -f, --parameters_file TEXT
              Path to YAML file containing parameters.

       -y, --parameters_yaml TEXT
              YAML string to be used as parameters.

       -b, --parameters_base64 TEXT
              Base64 encoded YAML string as parameters.

       --inject-input-path
              Insert the path of the input notebook as PAPERMILL_INPUT_PATH as a notebook parameter.

       --inject-output-path
              Insert the path of the output notebook as PAPERMILL_OUTPUT_PATH as a notebook parameter.

       --inject-paths
              Insert  the  paths  of  input/output  notebooks  as  PAPERMILL_INPUT_PATH/PAPERMILL_OUTPUT_PATH as
              notebook parameters.

       --engine TEXT
              The execution engine name to use in evaluating the notebook.

       --request-save-on-cell-execute / --no-request-save-on-cell-execute
              Request save notebook after each cell execution

       --autosave-cell-every INTEGER
              How often in seconds to autosave the notebook during long cell executions (0 to disable)

       --prepare-only / --prepare-execute
              Flag for outputting the notebook without execution, but with parameters applied.

       -k, --kernel TEXT
              Name of kernel to run. Ignores kernel name in the notebook document metadata.

       -l, --language TEXT
              Language for notebook execution. Ignores language in the notebook document metadata.

       --cwd TEXT
              Working directory to run notebook in.

       --progress-bar / --no-progress-bar
              Flag for turning on the progress bar.

       --log-output / --no-log-output
              Flag for writing notebook output to the configured logger.

       --stdout-file FILENAME
              File to write notebook stdout output to.

       --stderr-file FILENAME
              File to write notebook stderr output to.

       --log-level [NOTSET|DEBUG|INFO|WARNING|ERROR|CRITICAL]
              Set log level

       --start-timeout, --start_timeout INTEGER
              Time in seconds to wait for kernel to start.

       --execution-timeout INTEGER
              Time in seconds to wait for each cell before failing execution (default: forever)

       --report-mode / --no-report-mode
              Flag for hiding input.

       --version
              Flag for displaying the version.

       -h, --help
              Show this message and exit.

papermill 2.6.0                                     May 2025                                        PAPERMILL(1)