Установка в macOS
Всю установку делает один скрипт: он ставит Homebrew, .NET и Python, копирует агента в ваш
домашний каталог и регистрирует его на запуск при входе в систему. Работает он от вашего
обычного пользователя — без sudo.
Apple Silicon или Intel?
На каждое семейство чипов есть свой архив, и не тот даст вам бинарник, который вообще не запустится:
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 он ещё и добавляет
Homebrew в ваш
~/.zprofile. - Среду выполнения .NET 8 через Homebrew, с откатом на скрипт установки Microsoft в
~/.dotnet, если пакеты Homebrew недоступны. - Python 3.12 через Homebrew, если нет ничего новее 3.10.
- Самого агента — в
~/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 и так получает ускорение Metal,
потому что AI-движок включает его сам; на Intel-маках движок в любом случае работает на
процессоре.
AI на Mac
Установка зависимостей AI компилирует движок llama.cpp, для чего нужны инструменты командной строки Xcode; скрипт запускает их установку, если их нет. На Apple Silicon движок собирается с ускорением Metal, на Intel — работает на процессоре.
Обновление с установки до ребрендинга
Если старая запись launchd com.rfm.agent ещё на месте, скрипт выгружает и удаляет её —
иначе два агента конкурировали бы за одну учётную запись — и переносит ваши настройки и
скачанные модели из ~/Applications/RFM, оставляя старую папку вам на удаление.
Следующий шаг
Агент установлен, но ещё не подключён к вашей учётной записи: как связать устройство с учётной записью.
Обновлено 2026-07-31