macOS にインストールする
インストールは 1 つのスクリプトで完結します。Homebrew、.NET、Python を用意し、エージェントを
ホームディレクトリにコピーして、ログイン時に起動するよう登録します。実行はあなたの通常ユーザー
としてで、sudo は使いません。
Apple Silicon か Intel か
チップの系統ごとにアーカイブが 1 つずつあり、取り違えるとそもそも起動できないバイナリになります：
filemote-<バージョン>-osx-arm64.tar.gz—— Apple Silicon（M1 以降）filemote-<バージョン>-osx-x64.tar.gz—— Intel
分からない場合は → この Mac についてを開いてください。「チップ：Apple M…」なら Apple Silicon、「プロセッサ：Intel」なら Intel です。
インストール手順
tar xzf filemote-<バージョン>-osx-arm64.tar.gz
cd filemote-<バージョン>-osx-arm64
xattr -dr com.apple.quarantine .
chmod +x install-macos.sh
./install-macos.sh
xattr の行は、macOS がダウンロードしたファイルに付ける隔離フラグを消します。Finder で展開した
場合には重要で、そうでなければ無害です——
macOS がダウンロードをブロックする理由も
参照してください。
スクリプトを sudo で実行しないでください。自分のアカウントにインストールする前提で作られており、
権限の昇格が要るのは --prefix をあなたのユーザーが書き込めない場所に向けたときだけです。
スクリプトが用意するもの
- Homebrew。無ければ公式スクリプトからインストールします。Apple Silicon では
~/.zprofileへの Homebrew の追加も行います。 - .NET 8 ランタイム。Homebrew 経由で入れ、Homebrew のパッケージが利用できない場合は
Microsoft のインストールスクリプトで
~/.dotnetに入れます。 - Python 3.12。3.10 より新しいものが無ければ Homebrew 経由で入れます。
- エージェント本体。
~/Applications/Filemoteへ。インストールしたコピーの隔離フラグは消され ます。
すべてがあなたのユーザーとして動くため、エージェントが触れるのはあなたのアカウントが読める ファイルだけであり、しかもあなたがログインしている間に限られます。
launchd エージェント
--no-autostart を渡していなければ、スクリプトは
~/Library/LaunchAgents/com.filemote.agent.plist を書き出して読み込ませます。エージェントは毎回の
ログイン時に起動し、クラッシュしても自分で再起動します。
launchctl start com.filemote.agent # 今すぐ起動
launchctl stop com.filemote.agent # 停止
tail -f ~/Library/Logs/Filemote/filemote-agent.log
--no-autostart の場合は launchd の項目もログファイルも無いため、どちらのコマンドも当てはまり
ません——~/Applications/Filemote/FilemoteAgent を自分で起動します。
スクリプトのオプション
| オプション | 効果 |
|---|---|
--no-ai | AI サービスを省略——Python も依存関係も入れません |
--no-autostart | ファイルは入れるが launchd には何も登録しない |
--prefix /path | ~/Applications/Filemote 以外の場所にインストールする |
--model <id> | 主要な AI モデルをあらかじめ選んでおく |
--device cpu|gpu|auto | AI の計算デバイス |
--hf-token <token> | Hugging Face のトークン。利用申請が必要なモデル用 |
--gpu は macOS では受け付けられますが無視されます。Apple Silicon では AI エンジンが自分で有効
にするため、いずれにせよ Metal による高速化が働きます。Intel Mac ではどちらにしても CPU で動作
します。
Mac での AI
AI の依存関係をインストールすると llama.cpp エンジンがコンパイルされ、Xcode のコマンドライン ツールが必要になります。無ければスクリプトがそのインストールを促します。Apple Silicon では Metal 高速化付きでビルドされ、Intel では CPU で動作します。
名称変更前のインストールからのアップグレード
古い com.rfm.agent の launchd 項目が残っている場合、スクリプトはそれをアンロードして削除し——
そうしなければ 2 つのエージェントが同じアカウントを奪い合います——設定とダウンロード済みモデルを
~/Applications/RFM から移してきます。古いフォルダーは削除できるよう残されます。
次のステップ
エージェントはインストールされましたが、まだアカウントに接続されていません： デバイスをアカウントに接続する。
2026-07-31 に更新