Motile

Application for interactive tracking with global optimization

  • Caroline Malin-Mayor

tests codecov

The full documentation of the plugin can be found here.

An application for interactive tracking with motile Motile is a library that makes it easy to solve tracking problems using optimization by framing the task as an Integer Linear Program (ILP). See the motile documentation for more details on the concepts and method.


Installation

Users can download and install an executable application from the github release, or install from pypi in the environment of their choice (e.g. venv, conda) with the command pip install motile-tracker. Currently, the motile_tracker requires python >=3.10.

Developers can clone the GitHub repository and then use uv to install and run the code. See the developer guide in DEVELOPER.md for more information.

Running Motile Tracker

Start the executable application, or run motile_tracker from the command line.

Package the application into an executable and create the installer

Tagging any branch will automatically trigger the deploy.yml workflow, which pushes the tagged version to PyPi and creates a github release; draft release if the tag contains "-dev", pre-release if the tag contains "-rc' or a full release otherwise. In case of a draft or pre release, when the user updates the release notes and promotes it to a published release, github will trigger make_bundle_app.yml workflow which will create the Linux, Mac and Windows installer and will upload them as release artifacts to github.

Issues

If you encounter any problems, please file an issue along with a detailed description.

Version:

  • 4.1.1

Last updated:

  • 2025-10-22

First released:

  • 2025-03-25

License:

  • BSD 3-Clause

Supported data:

  • Information not submitted

Plugin type:

Open extension:

Save extension:

Python versions supported:

Operating system:

  • Information not submitted

Requirements:

  • napari<1,>=0.5
  • funtracks<2,>=1.4.0
  • appdirs<2,>=1
  • numpy<3,>=2
  • magicgui>=0.10.1
  • qtpy<3,>=2.4
  • scikit-image>=0.25
  • motile>=0.3
  • motile_toolbox==0.4.0
  • pydantic<3,>=2
  • tifffile[all]>=2025.1.10
  • tqdm<5,>=4
  • dask[array]>=2021.10.0
  • fonticon-fontawesome6<7,>=6
  • pyqtgraph<1,>=0.13
  • napari-orthogonal-views==0.0.6
  • lxml_html_clean<1,>=0.4
  • zarr<4,>=2.10
  • pyqt6<7,>=6.5; extra == "all"
Website by the napari team, original design by CZI. Go to napari main website.