Linux / arm64
Linux / amd64
Morpheus allows teams to build their own optimized pipelines that address cybersecurity and information security use cases. Morpheus provides development capabilities around dynamic protection, real-time telemetry, adaptive policies, and cyber defenses for detecting and remediating cybersecurity threats.
runtime
Docker imagePre-built Morpheus Docker images can be downloaded from NGC. The runtime
image includes pre-installed Morpheus and its dependencies:
docker pull nvcr.io/nvidia/morpheus/morpheus:25.02-runtime
Note: You must log into the NGC public catalog to download the Morpheus image.
Note about Morpheus versions: Morpheus uses Calendar Versioning (CalVer). For each Morpheus release there will be an image tagged in the form of
YY.MM-runtime
this tag will always refer to the latest point release for that version. In addition to this there will also be at least one point release version tagged in the form ofvYY.MM.00-runtime
this will be the initial point release for that version (ex.v25.02.00-runtime
). In the event of a major bug, we may release additional point releases (ex.v25.02.01-runtime
,v25.02.02-runtime
etc...), and theYY.MM-runtime
tag will be updated to reference that point release. Users who want to ensure they are running with the latest bug fixes should use a release image tag (YY.MM-runtime
). Users who need to deploy a specific version into production should use a point release image tag (vYY.MM.00-runtime
).
If you choose to run the Morpheus runtime image directly without Kubernetes, you will need to ensure that Docker has been properly configured for including the NVIDIA Container Runtime. This can be specified as either the default runtime or explicitly with the --runtime=nvidia
flag.
Example:
docker run --rm -ti --runtime=nvidia --gpus=all --net=host -v /var/run/docker.sock:/var/run/docker.sock nvcr.io/nvidia/morpheus/morpheus:25.02-runtime bash
More detailed instructions for this mode can be found in the Getting Started Guide on GitHub.
The Morpheus pipeline can be configured in two ways:
morpheus
)See the examples
directory in the GitHub repo for examples on how to configure a pipeline via Python.
The provided CLI (morpheus
) is capable of running the included tools as well as any linear pipeline.
morpheus
Usage: morpheus [OPTIONS] COMMAND [ARGS]...
Main entry point function for the CLI.
Options:
--debug / --no-debug [default: no-debug]
--log_level [CRITICAL|FATAL|ERROR|WARN|WARNING|INFO|DEBUG]
Specify the logging level to use. [default:
WARNING]
--log_config_file FILE Config file to use to configure logging. Use
only for advanced situations. Can accept
both JSON and ini style configurations
--plugin TEXT Adds a Morpheus CLI plugin. Can either be a
module name or path to a python module
--version Show the version and exit.
--help Show this message and exit.
Commands:
run Run one of the available pipelines
tools Run a utility tool
morpheus run
Usage: morpheus run [OPTIONS] COMMAND [ARGS]...
Run subcommand, used for running a pipeline
Options:
--num_threads INTEGER RANGE Number of internal pipeline threads to use [default: 64; x>=1]
--pipeline_batch_size INTEGER RANGE
Internal batch size for the pipeline. Can be much larger than the model batch size. Also used for Kafka consumers [default: 256;
x>=1]
--model_max_batch_size INTEGER RANGE
Max batch size to use for the model [default: 8; x>=1]
--edge_buffer_size INTEGER RANGE
The size of buffered channels to use between nodes in a pipeline. Larger values reduce backpressure at the cost of memory.
Smaller values will push messages through the pipeline quicker. Must be greater than 1 and a power of 2 (i.e. 2, 4, 8, 16, etc.)
[default: 128; x>=2]
--use_cpp BOOLEAN [Deprecated] Whether or not to use C++ node and message types or to prefer python. Only use as a last resort if bugs are
encountered. Cannot be used with --use_cpu_only [default: True]
--use_cpu_only Whether or not to run in CPU only mode, setting this to True will disable C++ mode. Cannot be used with --use_cpp
--manual_seed INTEGER RANGE Manually seed the random number generators used by Morpheus, useful for testing. [x>=1]
--help Show this message and exit.
Commands:
pipeline-fil Run the inference pipeline with a FIL model
pipeline-nlp Run the inference pipeline with a NLP model
pipeline-other Run a custom inference pipeline without a specific model type
morpheus tools
Usage: morpheus tools [OPTIONS] COMMAND [ARGS]...
Options:
--help Show this message and exit.
Commands:
autocomplete Utility for installing/updating/removing shell completion for Morpheus
onnx-to-trt Converts an ONNX model to a TRT engine
NVIDIA has observed false positive identification, by automated vulnerability scanning tools, of packages against National Vulnerability Database (NVD) security bulletins and GitHub Security Advisories (GHSA). This can happen due to package name collisions (e.g., Mamba Boa with GPG Boa, python docker SDK with docker core). NVIDIA is committed to providing the highest quality software distribution to our customers.
Morpheus is distributed as open source software under the Apache Software License 2.0.
NVIDIA AI Enterprise provides global support for NVIDIA AI software, including Morpheus. For more information on NVIDIA AI Enterprise please consult this overview and the NVIDIA AI Enterprise End User License Agreement.