MATLAB® based Python® Requirements manager

MPyReq is a MATLAB-based Python requirements manager that simplifies installing and configuring Python environments for MATLAB projects.

MPyReq is a MATLAB-based Python requirements manager that simplifies installing and configuring Python environments for MATLAB projects. It handles Python version management, package installations, git repository cloning, and weight file downloads with a simple API. MPyReq ensures consistent Python environments across sessions by caching configurations and providing runtime setup for your Python dependencies.

Setup

To Run:

1. Download MPyReq.m
2. Ensure MPyReq.m is on the MATLAB path. Not just in pwd, but on MATLAB path.
3. Call MPyReq.setInstallFolder(largeSSDFolder) to set the install folder. This only needs to be done once per machine. All subsequent uses of MPyReq share downloaded content from this folder.

Getting Started

Invoke help to see documentation

help MPyReq.m

Example

% Do this once per machine (saved in settings)
MPyReq.setInstallFolder("pathToLocalLargeSSDFolder")

% First ever run of this section     - Does installation and Runtime setup
% First run in a subsequent session  - Just Runtime Setup
% Second run in any session          - A very quick check to ensure env is up
MPyReq.python("3.12");
MPyReq.pipPackage("cellpose"); 


im = imread("AT3_1m4_01.tif");

% Use Python interface to call into Python code
% See: https://cellpose.readthedocs.io/en/latest/api.html
model = py.cellpose.models.CellposeModel(gpu=true);
outputs = model.eval(im);

labels = uint16(outputs{1});
imageshow(im,OverlayData=labels)

More Examples

Run the following examples after ensuring to set an installation folder using the call below. Ideally, this folder should be a fast access (e.g SSD) with ~15+ GB free space. These examples download large libraries and model files.

demoCellpose - Run https://www.cellpose.org/ cell segmentation model.

demoDepthPro - Run https://github.com/apple/ml-depth-pro A quick, sharp monocular metric depth model.

demoSAM2 - Run https://github.com/facebookresearch/sam2 Segment Anything Model 2

demoVGGT - Run https://vgg-t.github.io/ Visual Geometry Grounded Transformer