AiHummer
Español▾
Iniciar sesiónCuenta
v1.6.x▾
{ }Swagger

Inicio rápido

v1.6.x · actualizada 2026-11-10

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: Correo electrónico y teléfono. Una prueba disponible no necesita tarjeta ni cargo de verificación; se requiere pago para continuar con un plan de pago.

  1. 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.
  2. 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.
  3. En el asistente, elija el Nube camino, luego un plan (mensual/anual). La primera prueba de Personal Helper (cloud-personal) dura 14 días, sin tarjeta bancaria ni cargo de verificación. Se ofrece una sola vez. Otros planes solo ofrecen una prueba si el plan seleccionado en Billing la incluye expresamente; los planes empresariales no la incluyen. Para continuar hay que contratar el pago; iniciar la prueba no activa cargos automáticos. La prueba solo está disponible para cuentas sin suscripciones previas en la nube; utiliza una VM compartida, sin VM dedicada ni complementos de pago. Planes.
  4. Para pagar por factura, complete los datos de la empresa o autónomo en el perfil. No se requiere aprobación del operador; el pago con tarjeta y la prueba disponible no necesitan este paso.
  5. Elige uno nombre de subdominio (su dirección será <name>.cloud.aihummer.ru) y inicie la prueba disponible o pague el pedido. Verás el estado “Preparando tu asistente” con progreso. Detalles: Pedido y pago.
  6. 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

El panel web, las apps y los canales comparten una dirección pública del servidor. Abra la dirección pública indicada por el instalador; la dirección local predeterminada es http://localhost:8780/. El puerto elegido durante la instalación puede ser distinto.

http://localhost:8780/

Inicie sesión con el usuario y la contraseña de administrador elegidos en el asistente de instalación. Si se generaron credenciales iniciales automáticamente, use el resumen final; el archivo privado etc/initial-admin-password.txt solo corresponde a esa inicialización. No comparta las credenciales.

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.

Modelos

[!NOTE] Conecte un proveedor real de modelos para obtener respuestas útiles. No se necesita una clave API de pago: puede usar un modelo local compatible con OpenAI, una suscripción admitida o su propia clave API. Modelos · Proveedores de BYOK y LLM

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.
  • El panel web, las apps y los canales comparten una dirección pública del servidor. Abra la dirección pública indicada por el instalador; la dirección local predeterminada es http://localhost:8780/. El puerto elegido durante la instalación puede ser distinto.
  • No se puede encontrar la contraseña inicial — está dentro ~/.aihummer/etc/initial-admin-password.txt (solo si las credenciales iniciales se generaron automáticamente), 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?