Update README.md

README.md

@@ -118,6 +118,55 @@ ls -lh /opt/m5stack/data/amitaro-ja-jp-punsuka
 cat /opt/m5stack/data/models/mode_amitaro-ja-jp-punsuka.json
 ```
 
+
+## Direct download install
+
+If the `.deb` package is hosted on Hugging Face, you can install it directly on the Module LLM with `wget` and `dpkg`.
+
+Example: install the normal model.
+
+```sh
+cd /root && \
+wget -O llm-model-amitaro-ja-jp-normal_0.1_arm64.deb \
+  https://huggingface.co/tori29umai/MeloTTS-amitaro-ja-jp-package/resolve/main/llm-model-amitaro-ja-jp-normal_0.1_arm64.deb && \
+dpkg -i llm-model-amitaro-ja-jp-normal_0.1_arm64.deb && \
+apt -f install -y && \
+rm -f /root/llm-model-amitaro-ja-jp-normal_0.1_arm64.deb
+```
+
+Example: install the punsuka model.
+
+```sh
+cd /root && \
+wget -O llm-model-amitaro-ja-jp-punsuka_0.1_arm64.deb \
+  https://huggingface.co/tori29umai/MeloTTS-amitaro-ja-jp-package/resolve/main/llm-model-amitaro-ja-jp-punsuka_0.1_arm64.deb && \
+dpkg -i llm-model-amitaro-ja-jp-punsuka_0.1_arm64.deb && \
+apt -f install -y && \
+rm -f /root/llm-model-amitaro-ja-jp-punsuka_0.1_arm64.deb
+```
+
+If `wget` is not available, use `curl -L` instead.
+
+```sh
+cd /root && \
+curl -L -o llm-model-amitaro-ja-jp-normal_0.1_arm64.deb \
+  https://huggingface.co/tori29umai/MeloTTS-amitaro-ja-jp-package/resolve/main/llm-model-amitaro-ja-jp-normal_0.1_arm64.deb && \
+dpkg -i llm-model-amitaro-ja-jp-normal_0.1_arm64.deb && \
+apt -f install -y && \
+rm -f /root/llm-model-amitaro-ja-jp-normal_0.1_arm64.deb
+```
+
+### Download URLs
+
+```text
+https://huggingface.co/tori29umai/MeloTTS-amitaro-ja-jp-package/resolve/main/llm-model-amitaro-ja-jp-normal_0.1_arm64.deb
+https://huggingface.co/tori29umai/MeloTTS-amitaro-ja-jp-package/resolve/main/llm-model-amitaro-ja-jp-runrun_0.1_arm64.deb
+https://huggingface.co/tori29umai/MeloTTS-amitaro-ja-jp-package/resolve/main/llm-model-amitaro-ja-jp-yofukashi_0.1_arm64.deb
+https://huggingface.co/tori29umai/MeloTTS-amitaro-ja-jp-package/resolve/main/llm-model-amitaro-ja-jp-punsuka_0.1_arm64.deb
+https://huggingface.co/tori29umai/MeloTTS-amitaro-ja-jp-package/resolve/main/llm-model-amitaro-ja-jp-sasayaki-a_0.1_arm64.deb
+https://huggingface.co/tori29umai/MeloTTS-amitaro-ja-jp-package/resolve/main/llm-model-amitaro-ja-jp-sasayaki-b_0.1_arm64.deb
+```
+
 ## Install all packages
 
 ```sh
@@ -143,6 +192,39 @@ Remove all Amitaro model packages:
 dpkg -r $(dpkg -l | awk '/llm-model-amitaro-ja-jp/ {print $2}')
 ```
 
+
+## Update / overwrite install
+
+To update or overwrite an existing installation, install the new `.deb` with the same package name. `dpkg -i` will replace files owned by the same package.
+
+Example:
+
+```sh
+cd /root && \
+wget -O llm-model-amitaro-ja-jp-normal_0.1_arm64.deb \
+  https://huggingface.co/tori29umai/MeloTTS-amitaro-ja-jp-package/resolve/main/llm-model-amitaro-ja-jp-normal_0.1_arm64.deb && \
+dpkg -i llm-model-amitaro-ja-jp-normal_0.1_arm64.deb && \
+apt -f install -y && \
+rm -f /root/llm-model-amitaro-ja-jp-normal_0.1_arm64.deb
+```
+
+For clean reinstall, remove the package and its model directory first, then install again.
+
+```sh
+apt remove -y llm-model-amitaro-ja-jp-normal || true
+rm -rf /opt/m5stack/data/amitaro-ja-jp-normal
+rm -f /opt/m5stack/data/models/mode_amitaro-ja-jp-normal.json
+
+cd /root && \
+wget -O llm-model-amitaro-ja-jp-normal_0.1_arm64.deb \
+  https://huggingface.co/tori29umai/MeloTTS-amitaro-ja-jp-package/resolve/main/llm-model-amitaro-ja-jp-normal_0.1_arm64.deb && \
+dpkg -i llm-model-amitaro-ja-jp-normal_0.1_arm64.deb && \
+apt -f install -y && \
+rm -f /root/llm-model-amitaro-ja-jp-normal_0.1_arm64.deb
+```
+
+When publishing a new build, it is recommended to increment the Debian package version, for example from `0.1` to `0.2`.
+
 ## Volume warning
 
 The default playback volume on Module LLM may be loud. Before testing, lower the mixer gains.
@@ -285,6 +367,55 @@ ls -lh /opt/m5stack/data/amitaro-ja-jp-punsuka
 cat /opt/m5stack/data/models/mode_amitaro-ja-jp-punsuka.json
 ```
 
+
+## 直接ダウンロードしてインストール
+
+`.deb` パッケージを Hugging Face に置いている場合、Module LLM 実機上で `wget` と `dpkg` を使って直接インストールできます。
+
+例: normal モデルをインストールする場合。
+
+```sh
+cd /root && \
+wget -O llm-model-amitaro-ja-jp-normal_0.1_arm64.deb \
+  https://huggingface.co/tori29umai/MeloTTS-amitaro-ja-jp-package/resolve/main/llm-model-amitaro-ja-jp-normal_0.1_arm64.deb && \
+dpkg -i llm-model-amitaro-ja-jp-normal_0.1_arm64.deb && \
+apt -f install -y && \
+rm -f /root/llm-model-amitaro-ja-jp-normal_0.1_arm64.deb
+```
+
+例: punsuka モデルをインストールする場合。
+
+```sh
+cd /root && \
+wget -O llm-model-amitaro-ja-jp-punsuka_0.1_arm64.deb \
+  https://huggingface.co/tori29umai/MeloTTS-amitaro-ja-jp-package/resolve/main/llm-model-amitaro-ja-jp-punsuka_0.1_arm64.deb && \
+dpkg -i llm-model-amitaro-ja-jp-punsuka_0.1_arm64.deb && \
+apt -f install -y && \
+rm -f /root/llm-model-amitaro-ja-jp-punsuka_0.1_arm64.deb
+```
+
+`wget` が使えない場合は、`curl -L` を使ってください。
+
+```sh
+cd /root && \
+curl -L -o llm-model-amitaro-ja-jp-normal_0.1_arm64.deb \
+  https://huggingface.co/tori29umai/MeloTTS-amitaro-ja-jp-package/resolve/main/llm-model-amitaro-ja-jp-normal_0.1_arm64.deb && \
+dpkg -i llm-model-amitaro-ja-jp-normal_0.1_arm64.deb && \
+apt -f install -y && \
+rm -f /root/llm-model-amitaro-ja-jp-normal_0.1_arm64.deb
+```
+
+### ダウンロードURL
+
+```text
+https://huggingface.co/tori29umai/MeloTTS-amitaro-ja-jp-package/resolve/main/llm-model-amitaro-ja-jp-normal_0.1_arm64.deb
+https://huggingface.co/tori29umai/MeloTTS-amitaro-ja-jp-package/resolve/main/llm-model-amitaro-ja-jp-runrun_0.1_arm64.deb
+https://huggingface.co/tori29umai/MeloTTS-amitaro-ja-jp-package/resolve/main/llm-model-amitaro-ja-jp-yofukashi_0.1_arm64.deb
+https://huggingface.co/tori29umai/MeloTTS-amitaro-ja-jp-package/resolve/main/llm-model-amitaro-ja-jp-punsuka_0.1_arm64.deb
+https://huggingface.co/tori29umai/MeloTTS-amitaro-ja-jp-package/resolve/main/llm-model-amitaro-ja-jp-sasayaki-a_0.1_arm64.deb
+https://huggingface.co/tori29umai/MeloTTS-amitaro-ja-jp-package/resolve/main/llm-model-amitaro-ja-jp-sasayaki-b_0.1_arm64.deb
+```
+
 ## まとめてインストール
 
 ```sh
@@ -310,6 +441,39 @@ dpkg -r llm-model-amitaro-ja-jp-punsuka
 dpkg -r $(dpkg -l | awk '/llm-model-amitaro-ja-jp/ {print $2}')
 ```
 
+
+## 更新・上書きインストール
+
+既にインストール済みのモデルを更新または上書きしたい場合は、同じパッケージ名の新しい `.deb` を `dpkg -i` でインストールします。同じパッケージが所有するファイルは置き換えられます。
+
+例:
+
+```sh
+cd /root && \
+wget -O llm-model-amitaro-ja-jp-normal_0.1_arm64.deb \
+  https://huggingface.co/tori29umai/MeloTTS-amitaro-ja-jp-package/resolve/main/llm-model-amitaro-ja-jp-normal_0.1_arm64.deb && \
+dpkg -i llm-model-amitaro-ja-jp-normal_0.1_arm64.deb && \
+apt -f install -y && \
+rm -f /root/llm-model-amitaro-ja-jp-normal_0.1_arm64.deb
+```
+
+きれいに入れ直したい場合は、一度パッケージとモデルディレクトリを削除してから再インストールしてください。
+
+```sh
+apt remove -y llm-model-amitaro-ja-jp-normal || true
+rm -rf /opt/m5stack/data/amitaro-ja-jp-normal
+rm -f /opt/m5stack/data/models/mode_amitaro-ja-jp-normal.json
+
+cd /root && \
+wget -O llm-model-amitaro-ja-jp-normal_0.1_arm64.deb \
+  https://huggingface.co/tori29umai/MeloTTS-amitaro-ja-jp-package/resolve/main/llm-model-amitaro-ja-jp-normal_0.1_arm64.deb && \
+dpkg -i llm-model-amitaro-ja-jp-normal_0.1_arm64.deb && \
+apt -f install -y && \
+rm -f /root/llm-model-amitaro-ja-jp-normal_0.1_arm64.deb
+```
+
+新しいビルドを配布する場合は、Debian パッケージの `Version` を `0.1` から `0.2` のように上げることをおすすめします。
+
 ## 音量に関する注意
 
 Module LLM の初期再生音量が大きい場合があります。テスト前に以下のように音量系の mixer gain を下げてください。