# README.md のテンプレートになります

Python 3.12 のインストール（Windows 上） [クリックして展開]

以下のいずれかの方法で Python 3.12 をインストールする。Python がインストール済みの場合、この手順は不要である。

方法1：winget によるインストール

管理者権限のコマンドプロンプトで以下を実行する。管理者権限のコマンドプロンプトを起動するには、Windows キーまたはスタートメニューから「cmd」と入力し、表示された「コマンドプロンプト」を右クリックして「管理者として実行」を選択する。

winget install --scope machine --id Python.Python.3.12 -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --override "/quiet InstallAllUsers=1 PrependPath=1 Include_pip=1 Include_test=0 Include_launcher=1 InstallLauncherAllUsers=1"

--scope machine を指定することで、システム全体（全ユーザー向け）にインストールされる。このオプションの実行には管理者権限が必要である。インストール完了後、コマンドプロンプトを再起動すると PATH が自動的に設定される。

方法2：インストーラーによるインストール

  1. Python 公式サイト（https://www.python.org/downloads/）にアクセスし、「Download Python 3.x.x」ボタンから Windows 用インストーラーをダウンロードする。
  2. ダウンロードしたインストーラーを実行する。
  3. 初期画面の下部に表示される「Add python.exe to PATH」に必ずチェックを入れてから「Customize installation」を選択する。このチェックを入れ忘れると、コマンドプロンプトから python コマンドを実行できない。
  4. 「Install Python 3.xx for all users」にチェックを入れ、「Install」をクリックする。

インストールの確認

コマンドプロンプトで以下を実行する。

python --version

バージョン番号（例：Python 3.12.x）が表示されればインストール成功である。「'python' は、内部コマンドまたは外部コマンドとして認識されていません。」と表示される場合は、インストールが正常に完了していない。

AIエディタ Windsurf のインストール（Windows 上） [クリックして展開]

Pythonプログラムの編集・実行には、AIエディタの利用を推奨する。ここでは、Windsurfのインストールを説明する。Windsurf がインストール済みの場合、この手順は不要である。

管理者権限のコマンドプロンプトで以下を実行する。管理者権限のコマンドプロンプトを起動するには、Windows キーまたはスタートメニューから「cmd」と入力し、表示された「コマンドプロンプト」を右クリックして「管理者として実行」を選択する。

winget install --scope machine --id Codeium.Windsurf -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --custom "/SP- /SUPPRESSMSGBOXES /NORESTART /CLOSEAPPLICATIONS /DIR=""C:\Program Files\Windsurf"" /MERGETASKS=!runcode,addtopath,associatewithfiles,!desktopicon"
powershell -Command "$env:Path=[System.Environment]::GetEnvironmentVariable('Path','Machine')+';'+[System.Environment]::GetEnvironmentVariable('Path','User'); windsurf --install-extension MS-CEINTL.vscode-language-pack-ja --force; windsurf --install-extension ms-python.python --force; windsurf --install-extension Codeium.windsurfPyright --force"

--scope machine を指定することで、システム全体（全ユーザー向け）にインストールされる。このオプションの実行には管理者権限が必要である。インストール完了後、コマンドプロンプトを再起動すると PATH が自動的に設定される。

【関連する外部ページ】

Windsurf の公式ページ: https://windsurf.com/ 

### 4.2 インストール手順
注：ソースコードを実行する場合には，次の手順で実行に必要なソフトウェア類をインストールする

#### 4.2.1 NVIDIAドライバとCUDA（GPU向け並列計算プラットフォーム）のインストール
注：既にインストール済みの場合は，この手順は不要である

1. 新しくコマンドプロンプトを管理者として開く．そのために，Windowsキーを押して「cmd」と入力する
2. 「コマンドプロンプトを管理者として実行」を選択する
3. 以下のコマンドを1行ずつ実行する

winget install --scope machine Nvidia.CUDA --version 11.8

#### 4.2.2 CUDAのバージョン確認
同じコマンドプロンプトで以下のコマンドを実行する

nvidia-smi

#### 4.2.4 必要なPythonライブラリのインストール
1. 新しくコマンドプロンプトを管理者として開く．そのために，Windowsキーを押して「cmd」と入力する．「コマンドプロンプトを管理者として実行」を選択する
2. 以下のコマンドを実行する

CUDA 11.8を使用する場合（それ以外の場合は変更）

pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118
pip install -U protobuf transformers sentencepiece

## 5. プログラムファイルの準備
1. **コマンドプロンプトを開く**（通常モードで良い）．そのために，Windowsキーを押して「cmd」と入力する．
2. cdコマンドで**プログラムの保存先に移動**する．例えば，保存先をデスクトップにする場合は次のように入力する：

cd Desktop

3. 以下のコマンドで**プログラムファイルを作成**する（notepad は「メモ帳」である）：

notepad app.py

4. プログラムを入力し，Ctrl+Sキーを押して**保存**する（あるいは，メニューで保存操作を行う）：

プログラムのソースコード: [app.py](https://www.kkaneko.jp/ai/arrotpro-kujira/app.py)

ただし，プログラムファイルをダウンロードできる場合は，
ウェブブラウザで「プログラム」へのリンクを右クリック，「名前を付けてリンク先を保存」を選択（このとき，保存先を分かりやすい場所（例：デスクトップ）に指定）．そして，ファイル名を確認（例：app.py）