How to install MountWizzard4 (MW4) on StellarMate OS 2.0

MountWizzard4 is a tool for 10micron mounts. These steps install the latest version (v4) on StellarMate OS 2.0. They take about 5 to 10 minutes, and StellarMate must be connected to the internet.

Open a terminal on your StellarMate and run each command below in order.

1. Install uv

uv is a small tool that installs Python programs.

curl -LsSf https://astral.sh/uv/install.sh | sh

When it finishes, close the terminal and open a new one. Then check that uv works:

uv --version

You should see a version number.

2. Make a folder for MW4

mkdir ~/mw4
cd ~/mw4

3. Set up Python inside the folder

uv venv -p 3.13

This downloads Python 3.13 and keeps it inside the mw4 folder. It does not change the rest of your system.

4. Install MountWizzard4

uv pip install mountwizzard4 --pre

Version 4 is still marked as a beta, so --pre is needed. Without it you get the old version 3, which does not work here.

5. Start MountWizzard4

uv run mw4

Starting MW4 next time

Open a terminal and run:

cd ~/mw4
uv run mw4

Updating MW4

cd ~/mw4
uv pip install --upgrade mountwizzard4 --pre

Did you follow the old steps?

If you saw an error about hidapi, or a "404 Not Found" error for a PyQt5 file, delete the folder and start again from step 2:

rm -rf ~/mw4

You do not need to install PyQt5 by hand any more. MW4 version 4 installs everything it needs.

More help

See the official MountWizzard4 install guide: https://mworion.github.io/MountWizzard4/install/index.html