Начало
Первый запуск
Описывает Piomio 0.2.15Изменить страницу
Первый запуск занимает несколько минут, и почти всё происходит в чате. Ты придумываешь пароль, подключаешь ассистенту интеллект, а дальше он сам знакомится с тобой и по одному шагу ведёт остальную настройку. В приложении для компьютера терминал не нужен вовсе. На сервере понадобится один код от установщика.
1. Придумай пароль
В приложении для компьютера
Когда выбираешь Новый Piomio на этом компьютере (смотри Установка на Mac или ПК), окно показывает Первый запуск и просит только Новый пароль (минимум 8 символов) и Повторите пароль. Нажми Сохранить и войти. Код установки приложение уже передало само, копировать ничего не нужно.
Дальше окно приложения входит само. Пароль понадобится только в другом браузере, на http://localhost:41780, или на телефоне.
На сервере или из исходников
Открой чат (на сервере — по ссылке, которую показал установщик, в ней уже есть код, или http://localhost:8080 через его строку ssh -L). Форма Первый запуск спросит ещё и Код установки. Он подтверждает, что хаб настраивает тот, кто его поставил, а не первый, кто наткнулся на страницу.
Где взять код:
| Установка | Где код установки |
|---|---|
Сервер, через install.sh | Установщик печатает его в конце (Код установки: …). Потерял? sudo -iu piomio cat ~/.local/share/piomio/setup-code |
| Любой хаб | Строка в журнале, которая начинается с Piomio: first run (или Piomio: первый запуск) и заканчивается кодом |
На сервере код не меняется, пока кто-нибудь не задаст пароль. У хаба из исходников до этого момента при каждом запуске появляется новый, так что бери его из свежего журнала или задай свой заранее через PIOMIO_SETUP_TOKEN. Подробнее в разделе На сервере с Linux.
Забыл пароль? На сервере выполни piomio reset-password <новый-пароль> от пользователя, под которым работает Piomio (после sudo -iu piomio); из исходников — node packages/core/src/cli.ts reset-password <новый-пароль>. А ещё можно добавить passkey и входить без пароля (смотри Модель безопасности).
Язык хаба
Язык интерфейса на экране первого запуска становится языком хаба: это язык твоего браузера или тот, что выбран переключателем под формой. На нём приходят уведомления, сообщения в Telegram, карточки подтверждений и сообщения самого Piomio. Агенты отвечают на том языке, на котором ты им пишешь.
Сменить его потом можно прямо в чате («переключи язык хаба на английский») или в Настройках → Язык → Язык хаба. У каждого браузера может быть и свой Язык интерфейса в этом браузере, язык хаба он не меняет. Если на сервере задано PIOMIO_LANG=en или PIOMIO_LANG=ru, при настройке побеждает он (смотри Настройки и переменные окружения).
2. Подключи ассистенту интеллект
Пока ни один интеллект не работает, Piomio показывает только твоего ассистента: Привет! Я ваш ассистент, и карточку со строкой для каждого интеллекта, доступного на этом компьютере: Claude Code, Codex и Kimi Code.
- Войти в строке запускает собственный вход этого CLI. Входишь ты на странице разработчика, своим аккаунтом и со своей подпиской. Для Codex и Kimi Code вводишь на той странице одноразовый код с карточки; для Claude Code копируешь код, который покажет страница, и вставляешь его обратно в карточку (не в чат). Когда всё заработает, строка станет зелёной.
- Установить и войти появляется, если CLI ещё не установлен, а хаб умеет его поставить (приложение для компьютера и сервер, установленный через
install.sh). Это разовая загрузка на несколько сотен МБ, после которой начинается вход. - Проверить снова ищет CLI заново, например если ты только что поставил его или вошёл в него в терминале. Пока ни один интеллект не работает, хаб и сам проверяет каждые 30 секунд, так что вход, сделанный по SSH, подхватится в течение минуты.
Хватит и одного работающего интеллекта. Piomio никогда не берёт и не хранит токены этих CLI: каждый держит свой вход на том компьютере, где работает. Подробности и вход на сервере: Интеллект и вход.
Интеллектом могут быть и обычные API-ключи (Anthropic, OpenAI, OpenRouter или свой OpenAI-совместимый сервер), но только если хаб запущен с PIOMIO_API_KEYS=1. Тогда на карточке есть ещё Или API-ключ: Anthropic, OpenAI, OpenRouter, свой сервер. Без этой настройки карточка предлагает только CLI.
Если интеллект потом перестанет работать (вышел из аккаунта, удалён), та же карточка появится в чате. Всё, что напишешь в это время, подождёт, и ассистент ответит, как только интеллект снова заработает, если это случится в течение суток.
3. Познакомься с ассистентом
Как только интеллект заработал, приложение открывает чат с ассистентом, и он пишет первым. В новом хабе два агента: Ассистент и Исследователь. Знакомство ведёт сам ассистент, по одному короткому вопросу, и отвечать чаще всего можно кнопками:
- Его имя. Он спрашивает, как ты хочешь его называть, и предлагает три-четыре имени кнопками. Выбери или напиши своё.
- Его внешность. В чате появляется карточка профиля с аватаром и тем, насколько он проактивен. Поменяй их на карточке или просто скажи ему.
- Как с тобой общаться. На «ты» или на «вы», коротко или подробно, какой характер. Всё сказанное он записывает в свои инструкции.
- Твоя команда. Он спрашивает, кого ещё позвать в команду прямо сейчас, и предлагает три-четыре роли, которые тебе пригодятся (секретарь, программист, помощник по финансам…), плюс «пока никого». Для каждой выбранной роли показывает карточку с именем и описанием нового агента, переписывает её, если поправишь, и создаёт агента после твоего «да».
На сервере, где ссылка ещё ждёт входа в Tailscale (ты пропустил его в установщике), ассистент начинает с этого: карточка с кнопкой Войти в Tailscale, а потом ссылка, как только она начнёт открываться. Смотри Доступ из любого места.
На любой шаг можно ответить «не сейчас». Подробнее об агентах и командах: Агенты и команда.
4. Остальная настройка
После знакомства у ассистента остаётся ещё несколько предложений. Он заводит о них речь, когда к месту, сначала ответив на твой вопрос, по одному, и начинает каждое только с твоего согласия:
| Шаг | Что происходит |
|---|---|
| Telegram | Чат, уведомления и подтверждения на телефоне. Ты создаёшь бота у @BotFather, а карточка в чате принимает его токен. Смотри Telegram. |
| Запасной интеллект | Если установлен (или может быть установлен) второй CLI, он предлагает войти и в него, чтобы агенты продолжали работу, когда первый упрётся в лимит. Смотри Интеллект и вход. |
| Другие компьютеры | Карточка с одноразовой ссылкой, которую открываешь на другом компьютере или сервере, чтобы агенты могли работать и там. Смотри Машины и другие компьютеры. |
| Знакомство с тобой | Как к тебе обращаться, на каком языке, с чем помогать. Каждый факт он сохраняет в память. |
Скажешь «не сейчас», и шаг отложится: сам ассистент о нём больше не заговорит. Чтобы вернуться к оставшемуся, в любой момент скажи «давай продолжим настройку». Шаг засчитывается и сам, если ты уже сделал это по-другому, например подключил Telegram в Настройках.
Когда шагу нужен токен, ключ или пароль, ассистент показывает в чате защищённое поле, а не просит вставить его в сообщение. Значение сразу уходит в зашифрованное хранилище, модель видит только ссылку vault://. В первый раз карточка попросит создать хранилище: Сначала создадим хранилище, с паролем от 8 символов, который знаешь только ты. Смотри Модель безопасности.
С чего начать
Просто пиши, как человеку. Несколько дел в одном сообщении — тоже нормально. Несколько идей:
- «Напомни завтра в 10 позвонить стоматологу». Напоминание ставится сразу. Смотри Задачи, расписания и «Входящие».
- «Сравни три ноутбука для программирования до 150 тысяч». Всё, где есть шаги, уходит задачей в сторону, а ответ приходит ответом на твоё сообщение.
- «Каждое утро собирай новости про электромобили». Агент заведёт новостной канал и будет его вести. Смотри Каналы.
- «Сделай страницу для субботней прогулки в парке». Интерактивная страница прямо в чате. Смотри Страницы.
- «Подключи мой Notion». Появится карточка, и ты один раз входишь в аккаунт. Смотри Плагины и интеграции.
- Покажи агенту какое-нибудь дело в его браузере один раз, и потом он сделает его сам. Смотри Браузер и режим обучения.
Всё, что агент отправляет или покупает от твоего имени, сначала ждёт твоего нажатия на карточке. Смотри Подтверждения и автоматический режим. Как устроен чат: Чат.