ДокументацияПервый запуск

Начало

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

Описывает 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. Познакомься с ассистентом

Как только интеллект заработал, приложение открывает чат с ассистентом, и он пишет первым. В новом хабе два агента: Ассистент и Исследователь. Знакомство ведёт сам ассистент, по одному короткому вопросу, и отвечать чаще всего можно кнопками:

  1. Его имя. Он спрашивает, как ты хочешь его называть, и предлагает три-четыре имени кнопками. Выбери или напиши своё.
  2. Его внешность. В чате появляется карточка профиля с аватаром и тем, насколько он проактивен. Поменяй их на карточке или просто скажи ему.
  3. Как с тобой общаться. На «ты» или на «вы», коротко или подробно, какой характер. Всё сказанное он записывает в свои инструкции.
  4. Твоя команда. Он спрашивает, кого ещё позвать в команду прямо сейчас, и предлагает три-четыре роли, которые тебе пригодятся (секретарь, программист, помощник по финансам…), плюс «пока никого». Для каждой выбранной роли показывает карточку с именем и описанием нового агента, переписывает её, если поправишь, и создаёт агента после твоего «да».

На сервере, где ссылка ещё ждёт входа в Tailscale (ты пропустил его в установщике), ассистент начинает с этого: карточка с кнопкой Войти в Tailscale, а потом ссылка, как только она начнёт открываться. Смотри Доступ из любого места.

На любой шаг можно ответить «не сейчас». Подробнее об агентах и командах: Агенты и команда.

4. Остальная настройка

После знакомства у ассистента остаётся ещё несколько предложений. Он заводит о них речь, когда к месту, сначала ответив на твой вопрос, по одному, и начинает каждое только с твоего согласия:

ШагЧто происходит
TelegramЧат, уведомления и подтверждения на телефоне. Ты создаёшь бота у @BotFather, а карточка в чате принимает его токен. Смотри Telegram.
Запасной интеллектЕсли установлен (или может быть установлен) второй CLI, он предлагает войти и в него, чтобы агенты продолжали работу, когда первый упрётся в лимит. Смотри Интеллект и вход.
Другие компьютерыКарточка с одноразовой ссылкой, которую открываешь на другом компьютере или сервере, чтобы агенты могли работать и там. Смотри Машины и другие компьютеры.
Знакомство с тобойКак к тебе обращаться, на каком языке, с чем помогать. Каждый факт он сохраняет в память.

Скажешь «не сейчас», и шаг отложится: сам ассистент о нём больше не заговорит. Чтобы вернуться к оставшемуся, в любой момент скажи «давай продолжим настройку». Шаг засчитывается и сам, если ты уже сделал это по-другому, например подключил Telegram в Настройках.

Когда шагу нужен токен, ключ или пароль, ассистент показывает в чате защищённое поле, а не просит вставить его в сообщение. Значение сразу уходит в зашифрованное хранилище, модель видит только ссылку vault://. В первый раз карточка попросит создать хранилище: Сначала создадим хранилище, с паролем от 8 символов, который знаешь только ты. Смотри Модель безопасности.

С чего начать

Просто пиши, как человеку. Несколько дел в одном сообщении — тоже нормально. Несколько идей:

  • «Напомни завтра в 10 позвонить стоматологу». Напоминание ставится сразу. Смотри Задачи, расписания и «Входящие».
  • «Сравни три ноутбука для программирования до 150 тысяч». Всё, где есть шаги, уходит задачей в сторону, а ответ приходит ответом на твоё сообщение.
  • «Каждое утро собирай новости про электромобили». Агент заведёт новостной канал и будет его вести. Смотри Каналы.
  • «Сделай страницу для субботней прогулки в парке». Интерактивная страница прямо в чате. Смотри Страницы.
  • «Подключи мой Notion». Появится карточка, и ты один раз входишь в аккаунт. Смотри Плагины и интеграции.
  • Покажи агенту какое-нибудь дело в его браузере один раз, и потом он сделает его сам. Смотри Браузер и режим обучения.

Всё, что агент отправляет или покупает от твоего имени, сначала ждёт твоего нажатия на карточке. Смотри Подтверждения и автоматический режим. Как устроен чат: Чат.