AiHummer
Русский▾
ВойтиЛичный кабинет
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Начало работы/Быстрый старт

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

v1.1.x · обновлено 2026-07-21

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

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

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

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

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

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

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

Что понадобится: электронная почта, телефон и банковская карта (для пробного периода банк спишет 1 ₽ и сразу вернёт).

  1. Зарегистрируйтесь на my.aihummer.ru: укажите электронную почту, телефон и пароль, примите два согласия. Вы увидите экран подтверждения аккаунта.
  2. Подтвердите аккаунт — по звонку (введите последние цифры входящего номера) или кодом из письма. Вы увидите, что вход произошёл автоматически и открылся мастер первоначальной настройки. Подробно — Регистрация и вход.
  3. В мастере выберите путь «Облако», затем тариф (месяц/год). На младшем тарифе действует 10 дней бесплатно. Подробно — Тарифы.
  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. Первый вход

Когда служба поднимется, откройте веб‑интерфейс администратора на сервере (по умолчанию на приватном порту :8781):

http://localhost:8781/

На пустой базе создаётся логин admin, а стартовый пароль записывается в файл ~/.aihummer/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.

Помните про тестовую модель (mock)

Пока вы не подключите реальную модель, ответы приходят из детерминированной тестовой модели (mock) — она проверяет маршрут и интерфейс, но не выполняет рабочие задачи. Это удобно для проверки каналов, маршрутизации и агентов без затрат на модель. Как подключить настоящего провайдера (OpenAI, Anthropic, YandexGPT, GigaChat, Codex по подписке ChatGPT и др.) — на странице Модели.

[!NOTE] Для запуска и тестирования платный API‑ключ не нужен: без модели используется тестовая модель. Для рабочих ответов подключите локальную модель, поддерживаемый транспорт через подписку Codex/ChatGPT или собственный API‑ключ.

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

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

Куда дальше

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