AiHummer
Русский▾
ВойтиЛичный кабинет
v1.6.x▾
{ }Swagger

Быстрый старт

v1.6.x · обновлено 2026-11-10

[!NOTE] Результат: через 10–15 минут вы войдёте в админ‑панель, создадите первого агента и проверите ответ в тестовой сессии. Для рабочего ответа понадобится локальная модель, поддерживаемая подписка или API‑ключ.

Этот быстрый старт проводит через первый запуск AiHummer — от нуля до первого агента, отвечающего в канале. Он написан для человека, который делает это впервые: каждый шаг заканчивается тем, что вы должны увидеть, а в конце есть раздел «Если не получилось».

Сначала выберите путь

AiHummer можно получить двумя способами (подробное сравнение — во Введении):

  • Облако — мы держим сервер, вы получаете готовый адрес. Ничего устанавливать не нужно. → перейдите к разделу Путь A: облако.
  • Свой сервер (self-hosted) — вы ставите AiHummer на свой Linux-сервер одной командой. → перейдите к разделу Путь B: свой сервер.

Оба пути затем сходятся на общих шагах — первый агент и первый канал.

Путь A: облако

Что понадобится: Электронная почта и телефон. Для доступного пробного периода карта и проверочное списание не нужны; оплата требуется для платного продолжения.

  1. Зарегистрируйтесь на my.aihummer.ru: укажите электронную почту, телефон и пароль, примите два согласия. Вы увидите экран подтверждения аккаунта.
  2. Подтвердите аккаунт — по звонку (введите последние цифры входящего номера) или кодом из письма. Вы увидите, что вход произошёл автоматически и открылся мастер первоначальной настройки. Подробно — Регистрация и вход.
  3. В мастере выберите путь «Облако», затем тариф (месяц/год). Первый пробный период тарифа «Личный помощник» (cloud-personal) — 14 дней бесплатно без банковской карты и проверочного списания. Он предоставляется один раз. У других тарифов пробный период есть только при явном указании в выбранном тарифе Billing; у корпоративных тарифов он не включён. Для продолжения после пробного периода нужно оформить оплату: сам пробный период не подключает автоматические списания. Пробный период доступен только аккаунтам, у которых ещё не было облачной подписки; используется общая ВМ, без выделенной ВМ и платных дополнений. Тарифы.
  4. Для оплаты по счёту укажите реквизиты организации или ИП в профиле. Подтверждение оператором не требуется; для карты и доступного пробного периода этот шаг не нужен.
  5. Выберите имя поддомена (адрес будет <имя>.cloud.aihummer.ru) и начните доступный пробный период или оплатите заказ. Вы увидите статус «Готовим вашего помощника» с прогрессом. Подробно — Заказ и оплата.
  6. Дождитесь разворачивания (обычно несколько минут). Когда статус станет «Ваш помощник работает», нажмите «Открыть панель» — откроется админ‑панель вашего инстанса. Подробно — Управление инстансом.

Дальше настройка идёт в админ‑панели — переходите к первому агенту. Пароль администратора для облачного инстанса задаётся при первом открытии панели (отдельный файл с паролем, как при установке на своём сервере, здесь не нужен).

Путь B: свой сервер

Что понадобится: сервер с Linux (x86_64 или arm64), права sudo и PostgreSQL (или дайте установщику развернуть его самому). Полный список — в Требованиях.

Шаг 1. Получите персональную ссылку установки

Публичного скрипта установки нет — ссылка персональная. Зарегистрируйтесь на my.aihummer.ru, откройте экран «Установка» и нажмите «Получить персональную ссылку установки». Вы увидите готовую команду с кнопкой копирования.

Шаг 2. Установите одной командой

Запустите скопированную команду на сервере:

curl -fsSL -o install.sh "<личная ссылка установки>" && sudo bash install.sh

Установщик определит архитектуру, скачает и проверит подписанный пакет, разложит корень установки в ~/.aihummer и зарегистрирует службу gateway под systemd.

Ожидаемый результат: в терминале — журнал шагов установки и в конце сообщение об успешном запуске службы; systemctl status aihummer-gateway показывает active (running). Полное описание (каналы релизов, дополнительные сервисы, установка без root) — в Установке.

Шаг 3. Укажите PostgreSQL

Единственная жёсткая зависимость — PostgreSQL с расширением pgcrypto. Установщик настраивает подключение сам; если указываете базу вручную — конфиг-опцией AIHUMMER_DATABASE_URL:

AIHUMMER_DATABASE_URL=postgres://user:pass@localhost:5432/aihummer?sslmode=disable
-- один раз, в целевой базе
CREATE EXTENSION IF NOT EXISTS pgcrypto;

Миграции БД применяются автоматически при старте.

Ожидаемый результат: после перезапуска службы в журнале (journalctl --user -u aihummer-gateway) нет ошибок подключения к базе.

Шаг 4. Первый вход

Веб-панель, приложение и каналы используют один публичный адрес сервера. Откройте публичный адрес, указанный установщиком; локальный адрес по умолчанию — http://localhost:8780/. Выбранный при установке порт может отличаться.

http://localhost:8780/

Войдите с логином и паролем администратора, выбранными в мастере установки. Если установка вместо этого создала начальные данные входа автоматически, используйте её итоговую сводку; приватный файл etc/initial-admin-password.txt относится только к этому варианту начальной настройки. Не передавайте данные входа другим людям.

Первом входе

Шаг: создайте первого агента

Этот шаг общий для облака и своего сервера. В админ‑панели откройте «Агенты» → «+ Создать», задайте имя, профиль агента (системный промпт) и, по желанию, отдельную модель. Вы увидите нового агента плиткой в списке. Подробно, с настройкой характера и поведения — Агенты.

Шаг: подключите первый канал

Чтобы сообщения доходили до AiHummer, добавьте канал:

  • Telegram — основной канал, рекомендуемый для первой настройки; сквозной разбор «от BotFather до первого сообщения» — Telegram.
  • Сессии в Web UI — самый быстрый способ проверить агента до подключения внешнего канала.
  • MAX — российский мессенджер, тоже доступен.

Коннектор ставится на экране Плагины, затем настраивается на экране Каналы, где в блоке «Привязки» вы назначаете, какой агент ведёт этот канал. Отправьте сообщение в канал и проследите, как запрос обрабатывается от начала до конца.

Поговорите с агентом прямо из админ‑панели

Канал не обязателен для первой проверки: на странице «Сессии» кнопка «+ Новая сессия» открывает диалог с агентом прямо в админ‑панели. В поле ввода можно прикреплять файлы (изображения и документы — модель получает извлечённый текст), а два переключателя над перепиской включают показ стоимости обработки и вывода инструментов — удобно, чтобы увидеть, что агент делал на каждом шаге.

[!TIP] Можно также обращаться к AiHummer напрямую через его OpenAI-совместимый API без какого-либо канала:

POST /v1/chat/completions
Content-Type: application/json

{"model": "default", "messages": [{"role": "user", "content": "Привет"}]}

Установите "stream": true для потоковой передачи ответа по SSE.

Модели

[!NOTE] Для рабочих ответов подключите реального провайдера моделей. Платный API-ключ не обязателен: можно использовать локальную OpenAI-совместимую модель, поддерживаемую подписку или собственный API-ключ. Модели · BYOK и провайдеры LLM

Если не получилось

  • Команда установки завершилась ошибкой — проверьте, что запускаете её на Linux x86_64/arm64 и что персональная ссылка не устарела (она живёт 30 дней; получите новую на экране «Установка»). Диагностику см. в Установке.
  • Веб-панель, приложение и каналы используют один публичный адрес сервера. Откройте публичный адрес, указанный установщиком; локальный адрес по умолчанию — http://localhost:8780/. Выбранный при установке порт может отличаться.
  • Не нашли стартовый пароль — он в файле ~/.aihummer/etc/initial-admin-password.txt (только если начальные данные входа созданы автоматически), а не в журнале. См. Первый вход.
  • Оплата в облаке не прошла — статус подписки на сводке инстанса покажет причину; повторите оплату или для юрлиц выберите оплату по счёту, см. Заказ и оплата.
  • Агент не отвечает в канале — убедитесь, что в блоке «Привязки» канал привязан к агенту, а отправитель заведён в системе (по умолчанию агент отвечает только известным пользователям), см. Каналы.

Куда дальше

  • Установка — полный разбор развёртывания на своём сервере: каналы релизов, службы, проверка установки.
  • Первый вход — смените стартовый пароль и защитите вход, прежде чем давать доступ коллегам.
  • Модели — подключите реальную модель, чтобы агент начал отвечать по-настоящему.