Inicio rápido — AiHummer Documentos

Este inicio rápido te guía a través de tu primera ejecución de AiHummer, desde cero hasta que un primer agente responda en un canal. Está escrito para alguien que haga esto por primera vez. primera vez: cada paso termina con lo que deberías ver, y hay una sección de “Si no funcionó” al final.

Primero, elige tu camino

Hay dos maneras de obtener AiHummer (comparación completa en el Introducción):

Nube — nosotros administramos el servidor, tú obtienes una dirección lista. Nada que instalar. → ir a Camino A: nube.
Autoalojado (tu propio servidor) — instalas AiHummer en tu servidor Linux con un comando. → ir a Ruta B: tu propio servidor.

Ambos caminos convergen entonces en los pasos compartidos — primer agente y primer canal.

Camino A: nube

Lo que necesitarás: una dirección de correo electrónico, un número de teléfono y una tarjeta bancaria (para la prueba el banco cobra ₽1 y lo reembolsa de inmediato).

Registrar en my.aihummer.ru: ingrese su correo electrónico, teléfono y la contraseña, acepta los dos consentimientos. Verás la confirmación de la cuenta pantalla.
Confirme la cuenta — por llamada (ingrese los últimos dígitos del número entrante) o con el código del correo electrónico. Verás que el inicio de sesión ocurrió automáticamente y se abrió el asistente de incorporación. Detalles: Registro e inicio de sesión.
En el asistente, elija el Nube camino, luego un plan (mensual/anual). El el plan de entrada viene con un Prueba gratuita de 10 días. Detalles: Planes.
Rellena tu detalles de facturación (persona física o empresa/propietario único) — ellos son necesarios para la factura y el acta.
Elige uno nombre de subdominio (su dirección será <name>.cloud.aihummer.ru) y pagar. Verás el estado “Preparando tu asistente” con progreso. Detalles: Pedido y pago.
Espere la provisión (generalmente unos minutos). Cuando el estado cambie Tu el asistente está funcionando, hacer clic Abrir panel — la interfaz de administración web de tu la instancia se abre. Detalles: Panel de instancia.

La configuración continúa en la interfaz web de administración — vaya a su primer agenteLa contraseña de administrador para una instancia en la nube se establece cuando abres el panel por primera vez (el archivo de contraseña separado que se usa en la versión autohospedada no se necesita aquí).

Ruta B: tu propio servidor

Lo que necesitarás: un servidor Linux (x86_64 o arm64), sudo derechos, y PostgreSQL (o dejar que el instalador lo suministre). Lista completa: Requisitos.

Paso 1. Obtén tu enlace de instalación personal

No hay un script de instalación público: el enlace es personal. Regístrate en my.aihummer.ru, abra el Instalar pantalla y haz clic en “Obtener mi enlace personal de instalación”. Verás un comando listo con un botón para copiar.

Paso 2. Instalar con un comando

Ejecute el comando copiado en el servidor:

curl -fsSL -o install.sh "<your personal install link>" && sudo bash install.sh

El instalador detecta la arquitectura, descarga y verifica el paquete firmado, establece la raíz de instalación en ~/.aihummer y registra el servicio de gateway bajo systemd. Verás el registro del paso de instalación y, al final, un mensaje de servicio iniciado. Detalles completos (canales de lanzamiento, sidecars, instalación sin root): Instalación.

Paso 3. Apuntar a PostgreSQL

La única dependencia estricta es PostgreSQL con el pgcrypto extensión. El instalador conecta la conexión por ti; para configurar la base de datos manualmente, usa el AIHUMMER_DATABASE_URL opción de configuración:

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

-- once, in the target database
CREATE EXTENSION IF NOT EXISTS pgcrypto;

Las migraciones de la base de datos se aplican automáticamente al iniciar.

Paso 4. Primer inicio de sesión

Una vez que el servicio esté activo, abra la interfaz web de administración en el servidor (puerto privado) :8781 por defecto):

http://localhost:8781/

En una base de datos vacía un inicio de sesión admin se crea y se escribe la contraseña inicial en ~/.aihummer/etc/initial-admin-password.txt. Léelo, inicia sesión, luego cambia la contraseña y elimina el archivo inmediatamente — paso a paso en Primer inicio de sesión.

Paso: crea tu primer agente

Este paso es compartido por la nube y la versión autoalojada. En la interfaz web de administración, abre Agentes → + Crear, establece un nombre, una persona (mensaje del sistema) y, opcionalmente, un modelo dedicado. Verás al nuevo agente como un mosaico en la lista. Detalle completo, con ajuste de carácter y comportamiento: Agentes.

Paso: conecta tu primer canal

Para que los mensajes lleguen a AiHummer, añade un canal:

Telegram — el conector más listo para producción; una guía completa de principio a fin “de BotFather al primer mensaje” está en Telegram.
Sesiones en la interfaz web — la forma más rápida de probar un agente antes de conectar un canal externo.
MÁX — un mensajero ruso, también disponible.

El conector está instalado en el Complementos/Mercado pantalla, luego configurado en la Canales pantalla, donde la Enlaces bloquea conjuntos que determinan qué agente ejecuta ese canal. Envía un mensaje al canal y observa cómo un turno fluye de principio a fin.

Habla con el agente directamente desde la interfaz de administración

No se requiere un canal para una primera prueba: en el Sesiones página el botón “+ Nueva sesión” abre un chat con un agente justo dentro de la interfaz de administración. En el compositor puedes adjuntar archivos (imágenes y documentos — el modelo recibe el texto extraído), y dos interruptores arriba del hilo revelan costo por turno y salida de herramienta — útil para ver lo que hizo el agente en cada paso.

[!TIP] También puedes llamar a AiHummer directamente a través de su API compatible con OpenAI sin canal en absoluto:
POST /v1/chat/completions
Content-Type: application/json

{"model": "default", "messages": [{"role": "user", "content": "Hello"}]}
Conjunto "stream": true para transmisión SSE.

Recuerda el modelo simulado

Hasta que conectes un modelo real, las respuestas provienen de un simulación determinista — útil para probar canales, enrutamiento y agentes sin costo de modelo. Cómo conectar un proveedor real (OpenAI, Anthropic, YandexGPT, GigaChat, Codex a través de una suscripción de ChatGPT y más) está en el Modelos página.

[!NOTE] Un modelo real nunca es obligatorio: AiHummer funciona con gratuito/local Puntos finales compatibles con OpenAI y un transporte de suscripción Codex/ChatGPT.

Si no funcionó

El comando de instalación falló — verifica que lo ejecutes en Linux x86_64/arm64 y que el enlace personal no esté desactualizado (dura 30 días; obtén uno nuevo en el Pantalla de “Instalar”). Diagnósticos: Instalación.
La interfaz de administración no se abrirá — la interfaz web escucha en el puerto privado :8781, no el público :8780. Compruebe el servicio: systemctl status aihummer-gateway.
No se puede encontrar la contraseña inicial — está dentro ~/.aihummer/etc/initial-admin-password.txt, no en los registros. Ver Primer inicio de sesión.
El pago en la nube falló — el estado de la suscripción en el panel muestra el razón; reintentar, o (para empresas) elegir pagar por factura, ver Pedido y pago.
El agente no responde en un canal — asegúrate de que el canal esté vinculado a un agente en el bloque “Bindings”, y que el remitente es conocido por el sistema (por por defecto, el agente solo responde a usuarios conocidos), ver Canales.

¿A dónde vamos ahora?

Despliegue de producción autoalojado: Instalación.
Ajustar el comportamiento desde la interfaz de usuario: Configuración.
Asegura el primer inicio de sesión: Primer inicio de sesión.
Conectar un modelo: Modelos.