インストール

前提条件

uv は最速かつ最もモダンな Python パッケージマネージャです。

uv をインストール（既にある場合はスキップ）
- Linux / macOS
- Windows
Terminal window
curl -LsSf https://astral.sh/uv/install.sh | sh
Terminal window
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Mutsumi をインストール

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

インストール確認

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

uv tool install は Python 環境を自動的に分離管理します。Python の事前インストールは不要です。

Python 3.12+ がインストール済みであれば、最もシンプルな方法です：

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

確認：

mutsumi --version

pipx をインストール（既にある場合はスキップ）
Terminal window
```
pip install pipx
pipx ensurepath
```

Mutsumi をインストール

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

ソースコードを直接触りたい場合：

リポジトリをクローン

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

インストールして実行
Terminal window
```
pip install .
mutsumi --version
```
または uv を使う場合：
Terminal window
```
uv sync && uv run mutsumi --version
```

mutsumi コマンドが見つからない場合：

~/.local/bin を PATH に追加してください：

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

永続化するには、~/.bashrc / ~/.zshrc / ~/.config/fish/config.fish に追記してください。

pip install --user の場合は、Python Scripts ディレクトリを PATH に追加：

# PowerShell — Scripts パスを確認:
python -m site --user-site
# 対応する Scripts\ ディレクトリを PATH に追加

uv tool install や pipx でインストールした場合は自動的に PATH が設定されます。

Mutsumi は設定ファイルなしでも動作しますが、カスタマイズしたい場合：

mutsumi init --defaults

日本語に設定する場合：

mutsumi init --lang ja

pip uninstall mutsumi

uv tool uninstall mutsumi

設定・ログファイルの削除（オプション）：

rm -rf ~/.config/mutsumi/           # 設定
rm -rf ~/.local/share/mutsumi/      # ログ

Remove-Item -Recurse "$env:APPDATA\mutsumi"       # 設定
Remove-Item -Recurse "$env:LOCALAPPDATA\mutsumi"   # ログ

tasks.json はユーザーのデータです — 手動で判断してください。