My LLMの使い方
My LLMのインストールから，文章の入力・結果の取り出し，日常の操作までを説明します。画面はmacOSの英語表示です。Windowsではメニューバーの代わりにタスクトレイから操作します。
アプリで何ができるかを先に知りたい場合はMy LLMの紹介を，個々の設定項目を調べたい場合は設定リファレンスを参照してください。
初めて使う場合は，このページを先頭から進めてください。すでに使っている場合は，日常の呼び出し方，自分のタスクを作る，ホットキーとウィンドウ操作，困ったときから必要な説明を選べます。
1. アプリと接続先を用意する
My LLMをインストールする
GitHub Releasesから，自分のOSとCPUに合うファイルをダウンロードします。
| 環境 | 選ぶファイル | インストール方法 |
|---|---|---|
| macOS 13以降・Apple Silicon | My-LLM-vX.X.X-darwin-arm64.dmg | DMGを開き，My LLM.appをApplicationsへドラッグ |
| macOS 13以降・Intel | My-LLM-vX.X.X-darwin-x86_64.dmg | 同上 |
| Windows 11・x86_64 | My-LLM-vX.X.X-windows-x86_64.zip | 展開し，myllm.exeを起動。settings.exeは同じフォルダーに置く |
vX.X.Xはバージョン番号です。macOS向けの配布は署名・公証済み，Windows向けのZIPは未署名です。
通常の起動では，メニューバーまたはタスクトレイに常駐します。ウィンドウがすぐに現れなくても，アイコンのメニューからOpen Windowを選べます。
モデルを用意する
次のいずれかを用意します。
| 方法 | 必要な準備 |
|---|---|
| Ollamaのローカルモデル | Ollamaを起動し，使うモデルを取得。My LLMにはそのモデル名と接続先を設定 |
| Ollamaのクラウドモデル | Ollamaでサインインし，クラウドモデル名を指定。ローカルで起動したOllamaを経由して利用 |
| OpenAI・Anthropic API | 利用するサービスのAPIキーと，使うモデル名を準備 |
Ollamaを使う場合は，公式の開始手順を参照してください。My LLMの初回設定例では通常タスクにllama3.2，翻訳にtranslategemma:12bというローカルモデルを指定しています。Ollamaのローカルモデルを使う場合は，OllamaとモデルをMy LLMとは別に準備します。
ローカルモデルは，Ollamaのコマンドが使える環境では，次のように取得できます。すでに取得したモデルを使う場合は，SettingsのModel欄をその名前に合わせます。
ollama pull llama3.2
ollama pull translategemma:12bモデルごとに必要なメモリや実行速度が異なります。通常タスクだけを試す場合は，先に通常タスク用のモデルを用意し，翻訳は後から設定して構いません。
Ollamaのクラウドモデルを使う
ローカルで動いているOllamaを経由する場合は，Ollama側でサインインし，対象のクラウドモデルを利用できる状態にします。My LLMのProviderはollama，Base URLはhttp://localhost:11434のまま，Modelをクラウドモデル名へ変更します。サインインのコマンドは次のとおりです。
ollama signin利用する名前は，Ollamaがローカルのアプリ・CLI向けに案内するクラウドモデル名です。たとえば公式案内にはgemma4:cloudがあります。利用可能な名前はCloudの説明で確認してください。クラウドモデルの本体をローカルへダウンロードする必要はありません。
この経路ではOllamaがクラウドへの認証を扱います。My LLMからの接続先がlocalhostでも，選んだクラウドモデルには入力文章と指示が送られます。
2. 最初のタスクを実行する
- メニューからSettings…を開き，Providersで利用する接続先とDefault modelを設定します。クラウドAPIを使う場合は，APIキーも設定します。
- Tasksで，試すタスクのProviderをその接続先に合わせます。Modelが空欄なら，ProvidersのDefault modelを使います。まずは雛形の
polishやsummarizeを使えます。 - Settingsを閉じ，メニューからOpen Windowを選びます。
- Inputへ短い文章を貼り付けます。
- 左下で準備したタスクを選び，Runを押します。
- Outputへ結果が表示されたら，Copyでコピーし，元のアプリへ貼り付けます。
Providersは接続先と標準モデル，Tasksは文章へ適用する指示を設定する場所です。翻訳は別のTranslationで接続先とモデルを指定します。初回は通常のタスクで動作を確かめてから，翻訳を設定しても構いません。
Figure 1: 写真ワークショップのメモを要約した実行例です。上がInput，下がOutput，左下がタスクと使用モデル，右下がRunとCopyです。
| 画面の項目 | 役割 |
|---|---|
| Input | 処理する文章を入力・貼り付け。実行中は編集できません |
| Output | 結果を逐次表示。表示された文字を選択できます |
| タスク選択 | 実行する指示を選択。選ぶだけでは実行しません |
| 接続先・モデル表示 | 現在のタスクに使うプロバイダーとモデルを表示 |
| Run | Inputの文章を，選択中のタスクで処理 |
| Copy | Outputの結果をクリップボードへコピー |
生成結果は少しずつ追加されます。最初の応答まで待機表示になる場合があります。結果はモデルと指示によって異なるため，利用する前に内容を確認してください。
3. 日常の呼び出し方
文章を貼り付けてから実行する
Open Windowは，入力欄と出力欄を空にしてウィンドウを開きます。この操作ではクリップボードを読み取らず，タスクも実行しません。文章を自分で入力したいときや，貼り付けた内容を確認してから実行したいときに使います。
Open Windowで最初に選ばれるタスクは，GeneralのOpen Window taskで設定できます。
コピーしてからタスクを呼ぶ
- 普段使っているアプリで文章をコピーします。
- My LLMのメニューからタスクを選ぶか，そのタスクのホットキーを押します。
- ウィンドウが開き，クリップボードの文章を入力として自動実行されます。
Figure 2: メニューの例です。Open Windowは空のウィンドウを開き，個別のタスクは入力の取り込みと実行までを行います。タスク名とホットキーは設定によって変わります。
| メニュー | 動作 |
|---|---|
| Open Window | 空の入力・出力欄を開く |
| 個別のタスク／Translate | 入力を取り込み，そのタスクを実行 |
| Reload Config | 設定ファイルを読み直し，メニューやホットキーにも反映 |
| Open Config Folder | 設定ファイルのあるフォルダーを開く |
| Settings… | 設定ウィンドウを開く |
| Quit My LLM | 常駐を含めてアプリを終了 |
選択した文章を直接取り込む
GeneralのSend ⌘/Control+C to copy the selection.をオンにすると，タスクを呼ぶ際に前面のアプリへコピー操作を送り，選択した文章を取り込みます。オフの場合は，すでにクリップボードにある文章を使います。
macOSでは，このコピー操作のためにMy LLMへのアクセシビリティ許可が必要です。設定場所は，システム設定 → プライバシーとセキュリティ → アクセシビリティです。Appleの説明も参照してください。
許可がない場合や，前面のアプリでコピーできない場合は，新しい選択内容が取り込まれず，既存のクリップボードを使うことがあります。まず手動でコピーする方法から始めると，入力を確かめやすくなります。
結果を自動コピーする
Generalの自動コピーをオンにすると，正常に完了した結果がクリップボードへ入ります。タスクごとに有効・無効を分けられるため，推敲は自動コピー，説明は画面で読む，という使い分けもできます。
自動コピーの優先順位は，個別タスクまたは翻訳の指定 → Generalの指定 → 有効，です。Copyボタンは，自動コピーの設定と独立して使えます。
4. 設定を開く・保存する
メニューのSettings…で設定ウィンドウを開きます。General，Providers，Tasks，Translationの4つの画面があります。
macOSでは有効な変更が自動保存されます。WindowsではOKまたはApplyで保存します。保存後にSettingsを閉じると，My LLMが変更を読み直します。設定ファイルを直接編集した場合は，メニューのReload Configを選んでください。
設定項目の意味や値を調べるときは，設定リファレンスへ進んでください。
自分のタスクを作る
- Settings…のTasksで
+を押し，タスクIDとNameを設定します。IDはworkshop_summaryのような識別子，Nameはメニューに表示する名前です。 - Instructionへ，「何をしてほしいか」「どんな形式で返してほしいか」を書きます。たとえば，箇条書きの要約や，自分の仕事に合う文体の指示を登録できます。
- Providerを選び，必要ならModelを指定します。Modelを空欄にすると，その接続先のDefault modelを使います。
- 必要に応じてHotkeyと自動コピーを設定し，保存してSettingsを閉じます。
- Open Windowでタスクを選び，短い文章で試します。結果を見て，Instructionを調整します。
指示文の例と各項目の意味は，設定リファレンスのTasksで確認できます。翻訳用の指示はTasksへ追加せず，Translationで設定します。
設定項目を探す
| 調べたいこと | 詳しい説明 |
|---|---|
| 外観，表示言語，自動コピー，既定のタスク | General |
| 接続先，モデル，APIキー | Providers |
| タスク名，指示，個別のホットキー | Tasks |
| 翻訳エンジン，言語の振り分け | Translation |
| 設定ファイルを直接編集したい | 保存場所とTOMLの例 |
| ランチャーなどからGUIを呼びたい | コマンドからGUIを呼ぶ |
5. ホットキーとウィンドウ操作
ホットキー欄では，記録したいキーの組み合わせを入力します。ほかのアプリやOSと重複しない組み合わせを選んでください。
| 操作 | macOS | Windows |
|---|---|---|
| 画面のInputを実行 | ⌘R | Ctrl+R |
| Outputをコピー | ⌘C | Ctrl+C |
| ウィンドウを閉じる | ⌘WまたはEsc | Ctrl+WまたはEsc |
| アプリを終了 | ⌘QまたはメニューのQuit My LLM | Ctrl+QまたはトレイのQuit My LLM |
入力欄や出力欄で文字を選択してコピーした場合は，選択した文字のコピーが優先されます。結果全体を取り出したい場合は，Copyボタンを使うと明確です。
通常の常駐起動では，ウィンドウを閉じてもアプリは終了しません。タスク実行中にウィンドウを隠しても，それだけでは実行の中止になりません。アプリを終了するときはQuit My LLMを選びます。
困ったとき
| 状況 | 確認すること |
|---|---|
| 起動してもウィンドウがない | 常駐起動ではメニューのOpen Windowを選択 |
| タスクが見つからない | Tasksの登録とInstructionを確認。翻訳はTranslationで有効にする |
| 接続先やモデルのエラーが出る | ProvidersとTasksのProvider・Modelを確認。Ollamaでは起動状態とモデル取得も確認 |
| クラウドで認証エラーになる | APIキーと選択したプロバイダーを確認。Environmentの場合はアプリの起動環境も確認 |
| コピーした文章と違う内容が入る | 選択取り込みのオン・オフを確認。まず手動でコピーしてからタスクを呼ぶ |
| 選択した文章を取り込めない | macOSのアクセシビリティ許可と，前面アプリでコピーできるかを確認 |
| ホットキーが反応しない | 記録した組み合わせ，OS・他アプリとの重複を確認。メニューから実行できるかも確認 |
| Runが押せない | 実行中，または前回送った文章とタスクが同一の状態です。新しい文章を入力するか，タスクを変更 |
| 自動コピーされない | 個別タスクの設定がGeneralを上書きしていないか確認。エラー時は自動コピーされません |
| 設定変更が反映されない | 保存後にSettingsを閉じる。直接編集した場合はReload Configを選択 |
| Settings…を開けない | 配布ファイルを展開し直し，同梱の設定アプリがあるか確認。Windowsでは2つのEXEを同じフォルダーへ |
画面内のモデル名・タスク名は設定例です。画面の配置と基本操作はmacOSで確認しています。Windowsの手順はコードと同梱READMEに基づく説明で，この資料の作成時にはWindows上の実機撮影を行っていません。