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

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

Установите AiHummer

Установка выполняется одной командой; запустите её от root:

curl -fsSL http://cdn.aihummer.ru:9000/cdn/install.sh | 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;

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

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

Когда сервис поднимется, откройте админку на сервере:

http://localhost:8765/admin/

На пустой базе печатается одноразовый пароль администратора. Как его получить и сразу сменить — см. Первый вход.

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

Из админки добавьте канал, чтобы сообщения доходили до 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: Конфигурация.
Защитите первый вход: Первый вход.