Установка на Mac или ПК

Приложение для компьютера — самый простой способ запустить Piomio. В нём весь хаб (чаты, агенты, память и хранилище секретов), и оно держит его запущенным в фоне на твоём Mac или ПК. Всё нужное уже внутри, так что Node.js, Docker и WSL ставить не придётся. Минуты две, и готово.

Хочешь, чтобы Piomio жил на сервере, который не выключается? Смотри На сервере с Linux.

Что нужно#

• macOS 13.5 или новее, на Apple silicon или Intel (одно приложение для обоих).
• Windows 10 или 11, 64-битная (x64).
• Аккаунт хотя бы в одном из Claude Code, Codex или Kimi Code. Агенты думают через эти официальные CLI, в которые ты входишь со своей подпиской. Если CLI на компьютере ещё нет, Piomio поставит его сам (смотри Claude Code, Codex и Kimi Code).

Что скачать#

Возьми файл для своей системы из последнего релиза на GitHub или на piomio.io:

Остальные файлы релиза (latest.json, подписи .sig, …-mac.app.tar.gz, архивы для Linux и install.sh) нужны для обновлений и серверов. Тебе они не понадобятся.

Если твой хаб уже работает где-то ещё, на его странице-приглашении (это ссылка, которую он даёт, когда просишь подключить компьютер) тоже есть кнопка Скачать для … под твою систему.

Установка на macOS#

1. Открой образ диска и перетащи Piomio в Программы.
2. Запусти Piomio из Программ.

Приложение для Mac подписано и проверено Apple, поэтому macOS открывает его без предупреждений.

Установка на Windows#

1. Запусти piomio-setup-<version>-x64.exe. Он ставит Piomio только для твоей учётной записи, в %LOCALAPPDATA%\Piomio, и права администратора ему не нужны.
2. Открой Piomio.

Приложение для Windows пока не подписано, поэтому SmartScreen может написать «Система Windows защитила ваш компьютер». Нажми Подробнее, затем Выполнить в любом случае.

Первый запуск#

Первое окно спрашивает: Как вы будете пользоваться этим компьютером?

• Новый Piomio на этом компьютере. Хаб работает здесь, а чаты, агенты и хранилище секретов остаются на этом компьютере. Piomio запустится, и окно попросит придумать пароль (минимум 8 символов). Код установки вводить не нужно: приложение передаёт его само. Дальше приложение входит в своё окно без пароля, так что пароль понадобится только в другом браузере или на телефоне. Потом чат попросит войти в интеллект: всё это по шагам в разделе Первый запуск.
• Подключить к моему Piomio. Твой хаб уже работает на другом компьютере или сервере, а этот компьютер станет одной из его машин: агенты смогут пользоваться его Claude Code, Codex и папками, которые ты разрешишь. Вставь ссылку в поле Ссылка-приглашение, проверь Имя машины (подставляется имя компьютера) и нажми Подключить. Ссылку даёт сам хаб: напиши в его чате «подключи компьютер» или нажми Подключить машину на странице Машины. Ещё проще открыть ссылку-приглашение прямо на этом компьютере и нажать на её странице Открыть Piomio: приложение спросит Подключиться к …?, и всё уже будет заполнено. Подробнее в разделе Машины и другие компьютеры.

Если этот компьютер уже был подключён к хабу, окно предложит ещё и Использовать готовое подключение к ….

Если закрыть это первое окно, ничего не выбрав, приложение закроется. Передумать можно и потом: Настроить заново… в меню.

Claude Code, Codex и Kimi Code#

На компьютере хаб работает от твоего пользователя и думает через CLI в твоей учётной записи:

• Уже установлен и вход выполнен? Piomio найдёт его (он читает тот же PATH, что и твой терминал) и будет пользоваться им как есть. Входить второй раз не нужно.
• Не установлен? В его строке на карточке входа будет кнопка Установить и войти. Piomio скачает официальный пакет в свою папку с данными (разовая загрузка на несколько сотен МБ), а потом начнётся вход. Если позже поставишь CLI сам, будет работать твоя копия.

Входишь ты на странице самого разработчика, своим аккаунтом. Piomio лишь передаёт одноразовый код в CLI и никогда не берёт и не хранит его токены. Подробнее в разделе Интеллект и вход.

Значок в строке меню или в трее#

У Piomio есть значок в строке меню (macOS) или в системном трее (Windows). На Mac любой щелчок открывает меню. На Windows щелчок открывает окно, а правый щелчок — меню.

Когда хаб работает в приложении, в его Настройках есть блок Это приложение с теми же Выйти из Piomio и Сбросить Piomio….

Работает и с закрытым окном#

Если закрыть окно, Piomio не остановится. Telegram, задачи, расписания и напоминания продолжают работать, значок остаётся на месте. На Mac значок в Dock виден, только пока открыто окно. Чтобы вернуть окно, выбери его в меню значка или просто открой приложение.

Выйти из Piomio выключает всё до следующего запуска: никаких ответов в Telegram, напоминаний и фоновых задач.

Запускать при входе в систему запускает Piomio без окна. На Mac это LaunchAgent (~/Library/LaunchAgents/ai.piomio.app.plist), на Windows — запись «Piomio» в разделе Run реестра твоего пользователя. Приложение переписывает её при каждом запуске, так что она переживает и перенос приложения, и обновление.

Если хаб падает пять раз за две минуты, приложение перестаёт его перезапускать, а окно пишет Piomio не запустился с кнопками Показать журнал и Попробовать ещё раз.

Где лежат данные#

На Windows само приложение ставится в ту же папку, что и данные. Обновления и переустановка данные не трогают. Установка с тех времён, когда Piomio назывался Owlbot, продолжает пользоваться своей папкой Owlbot.

Порты#

Хаб слушает http://localhost:41780: его показывает окно приложения, и его же открывает любой браузер на этом компьютере (вход по паролю). Остальные порты: пульт безопасности на 41781 и прокси для исходящего трафика на 41789. Они подальше от портов, которые обычно заняты другими программами (8080, 18789 у OpenClaw). Все они отвечают только на этом компьютере.

В домашнюю сеть открыт только один порт: 41782, HTTPS-порт, через который дома подключается приложение для iPhone. Смотри Приложение для iPhone. Чтобы открывать Piomio не из дома, смотри Доступ отовсюду.

Чтобы сменить порт, создай в папке с данными файл desktop.json:

{ "port": 19000 }

Пульт тогда займёт следующий порт, а прокси — порт + 9, если не указать consolePort и egressPort отдельно. Чтобы изменение заработало, выбери Перезапустить в меню значка.

Если порт занят другой программой, меню напишет Порт … занят, а окно объяснит, в чём дело. Закрой ту программу или переведи Piomio на другой порт, как выше.

Безопасность на компьютере#

Приложение запускает хаб, его плагины и CLI-интеллекты от твоего же пользователя. В интернет они ходят через прокси исходящих соединений хаба, у каждого свой список разрешённых адресов. На Mac собственные команды CLI-интеллектов работают в песочнице macOS в пределах папки агента; на Windows песочницы вокруг интеллектов пока нет. Подтверждения, хранилище секретов и журнал аудита работают везде одинаково. Подробности в разделе Модель безопасности.

Начать с чистого листа#

Сбросить Piomio… в меню значка (или в Настройках → Это приложение) сначала спрашивает Удалить все данные Piomio? и перечисляет, что пропадёт: чаты, агенты, память, хранилище с твоими секретами, плагины, настройки, подключение этого компьютера к хабу и запись автозапуска. Отменить это нельзя.

• Удалить и начать заново удаляет всё и снова показывает первое окно.
• Удалить и выйти удаляет всё и закрывает приложение.
• Отмена оставляет всё как было.

Твои входы в Claude Code, Codex и Kimi Code остаются: они принадлежат этим программам, а не Piomio.

Удаление#

• macOS. Перетащи Piomio из Программ в Корзину. Запись автозапуска удалит себя сама при следующем входе в систему. Данные останутся в ~/Library/Application Support/Piomio; чтобы удалить и их, сначала выбери Сбросить Piomio… → Удалить и выйти.
• Windows. Открой Параметры → Приложения, найди Piomio и удали. Деинсталлятор спросит, удалить ли заодно и данные. Пока не ответишь «Да», они остаются.

Установка через свой ИИ#

Уже пользуешься Claude Code, Codex или Kimi Code на этом компьютере? Вставь в него это:

Установи Piomio на этот компьютер и настрой его для меня. Действуй по инструкции https://piomio.io/setup.md шаг за шагом. Спрашивай, когда решение за мной, и никогда не проси пароли или ключи. В конце скажи, как открыть чат.

Он сам поймёт, что это за компьютер, скачает нужный файл из релиза, поставит Piomio и спросит только то, что решать тебе: новый Piomio здесь или компьютер того Piomio, что у тебя уже есть. Пароль всё равно придумываешь ты сам, в окне Piomio. Дальше Piomio работает с тем же Claude Code, Codex или Kimi Code, и входить второй раз не нужно. Что он будет делать — открытая страница, её можно прочитать заранее.

Тихая установка#

Для многих компьютеров, скриптов и MDM:

• Windows: piomio-setup-<version>-x64.exe /S ставит без вопросов и запускает Piomio в фоне. Добавь /NOSTART, чтобы он остался выключенным.
• macOS: sudo installer -pkg piomio-<version>.pkg -target /. Пакет сначала закрывает запущенный Piomio, заменяет приложение и открывает его тому, кто сейчас вошёл в систему за экраном.
• Выбор при первом запуске без окна: запусти приложение с --mode hub --background (или --mode node). Файл приложения — /Applications/Piomio.app/Contents/MacOS/Piomio на Mac и %LOCALAPPDATA%\Piomio\Piomio.exe на Windows. Он же с --quit останавливает запущенный Piomio.
• Удалить пакет на Mac: sudo /Applications/Piomio.app/Contents/Resources/uninstall.sh <uid> <home> убирает приложение и его автозапуск. С --delete-data удаляются и данные.