Квикстарт — AiHummer Документация

Этот квикстарт проводит через первый запуск AiHummer — от установки до первого агента, отвечающего в канале. Подробности по каждому шагу есть на отдельных страницах, ссылки даны по ходу.

Установите AiHummer

Установка начинается в личном кабинете: зарегистрируйтесь на my.aihummer.ru, откройте экран «Установка» и получите персональную ссылку установки. Кабинет покажет готовую команду — запустите её на сервере через sudo (установка без root тоже поддерживается — см. Установку):

curl -fsSL "<личная ссылка установки>" | sudo bash

Установщик определит архитектуру, скачает и проверит подписанный бандл, разложит корень установки и зарегистрирует сервис gateway под systemd. Полное описание (персональная ссылка, каналы релизов, выбор сайдкаров, проверка) — в Установке.

Укажите PostgreSQL

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

AIHUMMER_DATABASE_URL=postgres://user:pass@localhost:5432/aihummer?sslmode=disable

-- один раз, в целевой базе
CREATE EXTENSION IF NOT EXISTS pgcrypto;

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

Откройте админку

Когда сервис поднимется, откройте админ-Web UI на сервере. Он работает на своём приватном слушателе (по умолчанию :8781, AIHUMMER_WEBUI_ADDR) и раздаётся по корневому пути / — не на публичном порту gateway:

http://localhost:8781/

На пустой базе gateway создаёт логин admin и записывает стартовый пароль в файл ~/.aihummer/etc/initial-admin-password.txt. Прочитайте его, войдите, сразу смените пароль и удалите файл — подробности в Первом входе.

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

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

Telegram — самый готовый к продакшену коннектор для старта.
Веб-виджет — самый быстрый способ проверить всё прямо в браузере.
MAX — российский мессенджер, тоже доступен.

Создайте первого агента

В админке создайте агента: задайте ему персону и, по желанию, отдельную модель. Привяжите его к только что добавленному каналу (блок «Привязки» на странице «Каналы»), чтобы роутер знал, куда отправлять сообщения. Отправьте сообщение через канал и проследите, как ход проходит от начала до конца.

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

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

[!TIP] Можно также обращаться к AiHummer напрямую через его OpenAI-совместимый API без какого-либо канала:
POST /v1/chat/completions
Content-Type: application/json

{"model": "default", "messages": [{"role": "user", "content": "Привет"}]}
Установите "stream": true для стриминга по SSE.

Помните про mock-модель

Пока вы не подключите реальную модель, ответы приходят из детерминированного mock — это удобно для проверки каналов, роутинга и агентов без затрат на модель.

[!NOTE] Реальная модель никогда не обязательна: AiHummer работает на свободных/локальных OpenAI-совместимых эндпоинтах и транспорте через подписку Codex/ChatGPT. Чтобы подключить своего провайдера (BYOK), задайте конфиг-опции AIHUMMER_LLM_* — это опционально. Подробнее — в Требованиях.

Куда дальше

Продакшен-развёртывание: Установка.
Настройка поведения из UI: Конфигурация.
Защитите первый вход: Первый вход.