AiHummer
Dansk▾
Log indKonto
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Kom godt i gang/Hurtigstart

Hurtigstart

v1.1.x · opdateret 2026-07-20

Denne quickstart tager dig igennem din første AiHummer-kørsel — fra nul til en første agent, der svarer i en kanal. Den er skrevet til en, der gør dette for første gang: hvert skridt ender med hvad du bør se, og der er en “Hvis det ikke virkede” sektion til sidst.

Først, vælg din vej

Der er to måder at få AiHummer på (fuld sammenligning i Introduktion):

  • Sky — vi driver serveren, du får en klar adresse. Intet at installere. → gå til Sti A: sky.
  • Selvhostet (din egen server) — du installerer AiHummer på din Linux-server med en kommando. → gå til Sti B: din egen server.

Begge stier mødes derefter på de fælles trin — første agent og første kanal.

Sti A: sky

Hvad du får brug for: en e-mailadresse, et telefonnummer og et bankkort (til prøven opkræver banken ₽1 og refunderer det straks).

  1. Tilmeld dig my.aihummer.ru: indtast din e-mail, telefon og adgangskode, accepter de to samtykker. Du vil se konto-bekræftelsen skærm.
  2. Bekræft kontoen — via opkald (indtast de sidste cifre af det indgående nummer) eller med koden fra e-mailen. Du vil se, at log ind skete automatisk og onboarding-guiden åbnede. Detaljer: Registrering og log ind.
  3. I guiden vælg Sky sti, så en plan (månedligt/årligt). indgangsplan kommer med en 10-dages gratis prøveperiode. Detaljer: Planer.
  4. Udfyld din faktureringsoplysninger (individ eller virksomhed/enkeltperson) — de er nødvendige for fakturaen og akten.
  5. Vælg en subdomænenavn (din adresse vil være <name>.cloud.aihummer.ru) og betale. Du vil se statusen “Forbereder din assistent” med fremdrift. Detaljer: Bestilling og betaling.
  6. Vent på levering (normalt et par minutter). Når status ændres Din assistenten kører, klik Åbn panel — webadministratorens brugerflade for din forekomst åbner. Detaljer: Forekomst-dashboard.

Konfiguration fortsætter i webadmin-brugergrænsefladen — gå til din første agent. Administratoradgangskoden for en cloud-instans sættes, når du først åbner panelet (den separate adgangskodefil, der bruges i selvhostede løsninger, er ikke nødvendig her).

Sti B: din egen server

Hvad du får brug for: en Linux-server (x86_64 eller arm64), sudo rettigheder, og PostgreSQL (eller lad installationsprogrammet provisionere det). Fuld liste: Krav.

Der er ikke noget offentligt installationsscript — linket er personlig. Tilmeld dig my.aihummer.ru, åben Installer skærm og klik på “Få mit personlige installationslink”. Du vil se en klar kommando med en kopieringsknap.

Trin 2. Installer med en kommando

Kør den kopierede kommando på serveren:

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

Installeren registrerer arkitekturen, downloader og bekræfter den underskrevne pakke, angiver installationsroden på ~/.aihummer og registrerer gateway-tjenesten under systemd. Du vil se installations-trinnets log og til sidst en meddelelse om, at tjenesten er startet. Fuldstændige detaljer (udgivelseskanaler, sidecars, rootless installation): Installation.

Trin 3. Peg på PostgreSQL

Den eneste hårde afhængighed er PostgreSQL med pgcrypto udvidelse. Installatøren forbinder forbindelsen for dig; for at indstille databasen manuelt, brug AIHUMMER_DATABASE_URL konfigurationsmulighed:

AIHUMMER_DATABASE_URL=postgres://user:pass@localhost:5432/aihummer?sslmode=disable
-- once, in the target database
CREATE EXTENSION IF NOT EXISTS pgcrypto;

Databasemigrationer anvendes automatisk ved opstart.

Trin 4. Første login

Når tjenesten er oppe, skal du åbne admin Web UI på serveren (privat port :8781 som standard):

http://localhost:8781/

På en tom database en login admin oprettes, og den oprindelige adgangskode skrives til ~/.aihummer/etc/initial-admin-password.txt. Læs det, log ind, så skift adgangskoden og slet filen med det samme — trin for trin ind Første login.

Trin: opret din første agent

Dette trin deles af cloud og selvhostet. I webadmin-UI åbner du “Agenter” → “+ Skab”, angiv et navn, en persona (systemprompt) og eventuelt en dedikeret model. Du vil se den nye agent som en flise i listen. Fuld detaljer, med karakter- og adfærdstilpasning: Agenter.

Trin: tilslut din første kanal

For at lade beskeder nå AiHummer, tilføj en kanal:

  • Telegram — den mest produktionsklare stikforbindelse; en komplet gennemgang fra start til slut “fra BotFather til den første besked” er i Telegram.
  • Sessioner i Web UI — den hurtigste måde at teste en agent på, før man forbinder en ekstern kanal.
  • MAX — en russisk budbringer, også tilgængelig.

Stikket er installeret på Plugins/Markedsplads skærm, derefter konfigureret på Kanaler skærm, hvor “Bindinger” Blokér, hvilke agenter der kører den kanal. Send en besked til kanalen og se en tur flyde fra start til slut.

Tal med agenten direkte fra administrationsbrugerfladen

En kanal er ikke påkrævet til en første test: på “Sessioner” siden åbner knappen “Ny session” en chat med en agent direkte i admin-brugergrænsefladen. I komponisten kan du vedhæft filer (billeder og dokumenter — modellen modtager den udtrukne tekst), og to kontakter over tråden afslører pr.-træk omkostning og værktøjsoutput — praktisk for at se, hvad agenten gjorde på hvert trin.

[!TIP] Du kan også ringe til AiHummer direkte via dets OpenAI-kompatible API uden nogen kanal overhovedet:

POST /v1/chat/completions
Content-Type: application/json

{"model": "default", "messages": [{"role": "user", "content": "Hello"}]}

Sæt "stream": true til SSE streaming.

Husk maketmodellen

Indtil du tilslutter en rigtig model, kommer svarene fra en deterministisk mock — praktisk til at teste kanaler, routing og agenter uden modelomkostninger. Hvordan man forbinder en rigtig udbyder (OpenAI, Anthropic, YandexGPT, GigaChat, Codex via et ChatGPT-abonnement og mere) findes på Modeller side.

[!NOTE] En rigtig model er aldrig obligatorisk: AiHummer kører på gratis/lokal OpenAI-kompatible slutpunkter og en Codex/ChatGPT-abonnementsforbindelse.

Hvis det ikke virkede

  • Installationskommandoen mislykkedes — tjek, at du kører det på Linux x86_64/arm64 og at det personlige link ikke er forældet (det lever i 30 dage; få et nyt på «Installér» skærm). Diagnostik: Installation.
  • Admin-grænsefladen åbner ikke — Web-brugergrænsefladen lytter på den private port :8781, ikke offentligheden :8780. Tjek tjenesten: systemctl status aihummer-gateway.
  • Kan ikke finde den oprindelige adgangskode — det er inden ~/.aihummer/etc/initial-admin-password.txt, ikke i loggene. Se Første login.
  • Cloud-betaling mislykkedes — abonnementsstatus på dashboardet viser grund; prøv igen, eller (for virksomheder) vælg betaling via faktura, se Bestilling og betaling.
  • Agenten svarer ikke i en kanal — sørg for, at kanalen er bundet til en agent i “Bindings”-blokken, og at afsenderen er kendt af systemet (af standard svarer agenten kun kendte brugere), se Kanaler.

Hvor til næste