Installation

Requirements

Before installing MIRA, ensure your system meets the following specifications:

🐍 Python

Version 3.10 to 3.13

Make sure Python is added to your system PATH.

πŸ’» Operating System

Cross-platform

Fully supported on Linux, Windows, and macOS.

πŸ“· Camera

USB Microscope

Optimized for ArduCam 20MP, but compatible with most UVC cameras.

β€”

Installation Methods

Choose the method that best fits your needs:

The easiest way to get MIRA up and running. This will install the latest stable version and all required dependencies.

pip install mira-microscopy

Use this method if you want the latest features from the repository.

git clone https://forge.ird.fr/phim/sravel/mira.git
cd mira
pip install .

Select this if you intend to contribute to MIRA or modify the source code.

git clone https://forge.ird.fr/phim/sravel/mira.git
cd mira
pip install -e .[dev]

Linux users β€” OpenCV Qt conflict

On Linux, ultralytics pulls in opencv-python which bundles its own Qt libraries, conflicting with PyQt5. After any installation method above, force the headless variant:

pip install opencv-python-headless --force-reinstall

See the FAQ for the full error message and fix.

β€”

Dependencies

MIRA relies on several powerful libraries to handle imaging and deep learning. These are installed automatically:

πŸ“¦ View detailed dependency list

  • GUI: PyQt5 (with custom QSS themes)

  • Computer Vision: OpenCV (opencv-python-headless)

  • Deep Learning: Ultralytics YOLO, PyTorch

  • Data Analysis: NumPy, Pandas, OpenPyXL

β€”

πŸ’‘ Pro Tip: Virtual Environments

We strongly recommend installing MIRA inside a virtual environment to avoid conflicts with other Python packages:

python -m venv mira-env
# On Windows:
mira-env\Scripts\activate
# On Linux/macOS:
source mira-env/bin/activate
pip install mira-microscopy