Installation

Prerequisites

• Python 3.12+
• macOS / Linux / Windows (PowerShell, CMD, or Windows Terminal)

Install

uv (recommended)

uv tool install git+https://github.com/ywh555hhh/Mutsumi.git

pip

pip install git+https://github.com/ywh555hhh/Mutsumi

pipx

pipx install git+https://github.com/ywh555hhh/Mutsumi

From source

git clone https://github.com/ywh555hhh/Mutsumi.git
cd Mutsumi
pip install .

Or with uv:

cd Mutsumi && uv sync && uv run mutsumi

Verify

mutsumi --version
# Expected: mutsumi, version 0.4.0b1

command not found?

Linux / macOS

Ensure ~/.local/bin is in your PATH:

export PATH="$HOME/.local/bin:$PATH"

Windows

If installed with pip install --user, add the Scripts directory to PATH:

# PowerShell — check your user Scripts path:
python -m site --user-site
# Then add the corresponding Scripts/ directory to PATH

With uv tool install or pipx, the PATH is configured automatically.

Install uv (optional)

Linux / macOS

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

Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Uninstall

pip

pip uninstall mutsumi

uv

uv tool uninstall mutsumi

Config and log files can be removed manually:

Linux / macOS

rm -rf ~/.config/mutsumi/           # Config
rm -rf ~/.local/share/mutsumi/      # Logs

Windows

Remove-Item -Recurse "$env:APPDATA\mutsumi"       # Config
Remove-Item -Recurse "$env:LOCALAPPDATA\mutsumi"   # Logs