AiHummer
Norsk▾
Logg påKonto
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Komme i gang/Rask start

Rask start

v1.0.x · oppdatert 2026-07-20

Denne hurtigstarten tar deg gjennom din første AiHummer-kjøring — fra null til en første agent som svarer i en kanal. Den er skrevet for noen som gjør dette for første gang første gang: hvert steg avsluttes med hva du bør se, og det finnes en “Hvis det ikke fungerer”-seksjon på slutten.

Først, velg din vei

Det er to måter å få AiHummer på (full sammenligning i Introduksjon):

  • Sky — vi kjører serveren, du får en ferdig adresse. Ingenting å installere. → gå til Sti A: sky.
  • Selvhostet (egen server) — du installerer AiHummer på Linux-serveren din med en kommando. → gå til Sti B: din egen server.

Begge stiene møtes deretter på de felles trinnene — første agent og første kanal.

Sti A: sky

Det du trenger: en e-postadresse, et telefonnummer og et bankkort (for prøveperioden belaster banken ₽1 og refunderer det umiddelbart).

  1. Registrer deg på my.aihummer.ru: skriv inn e-posten din, telefon og passord, aksepter de to samtykkene. Du vil se konto-bekreftelsen skjerm.
  2. Bekreft kontoen — via telefonsamtale (oppgi de siste sifrene i det innkommende nummeret) eller med koden fra e-posten. Du vil se at påloggingen skjedde automatisk og onboarding-veiviseren åpnet. Detaljer: Registrering og pålogging.
  3. I veiviseren velg Sky sti, deretter en plan (månedlig/årlig). inngangsplan følger med en 10-dagers gratis prøveperiode. Detaljer: Planer.
  4. Fyll inn din faktureringsdetaljer (individ eller selskap/enkeltpersonforetak) — de er nødvendig for fakturaen og handlingen.
  5. Velg en underdomene navn (din adresse vil være <name>.cloud.aihummer.ru) og betale. Du vil se statusen “Forbereder assistenten din” med fremdrift. Detaljer: Bestilling og betaling.
  6. Vent på provisjonering (vanligvis noen få minutter). Når statusen endres Din assistenten kjører, klikk Åpne panel — administrasjonsgrensesnittet på nettet til din forekomst åpnes. Detaljer: Forekomstdashbord.

Konfigurasjon fortsetter i webadmingrensesnittet — gå til din første agent. Administrasjonspassordet for en skyinstans settes når du åpner panelet for første gang (den separate passordfilen som brukes ved selv-hosting er ikke nødvendig her).

Sti B: din egen server

Det du trenger: en Linux-server (x86_64 eller arm64), sudo rettigheter, og PostgreSQL (eller la installasjonsprogrammet konfigurere det). Full liste: Krav.

Trinn 1. Få din personlige installasjonslenke

Det finnes ingen offentlig installasjonskript — lenken er personlig. Registrer deg på my.aihummer.ru, åpne Installer skjerm og klikk på “Få min personlige installasjonslenke”. Du vil se en klar kommando med en kopieringsknapp.

Steg 2. Installer med en kommando

Kjør den kopierte kommandoen på serveren:

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

Installeren oppdager arkitekturen, laster ned og bekrefter den signerte pakken, legger ut installasjonsrot på ~/.aihummer og registrerer gateway-tjenesten under systemd. Du vil se installasjonssteg-loggen og til slutt en melding om at tjenesten er startet. Fullstendige detaljer (utgivelseskanaler, sidecars, rootless installasjon): Installasjon.

Trinn 3. Pek på PostgreSQL

Den eneste harde avhengigheten er PostgreSQL med pgcrypto utvidelse. Installatøren kobler til forbindelsen for deg; for å sette opp databasen manuelt, bruk AIHUMMER_DATABASE_URL konfigurasjonsvalg:

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

Databasemigrasjoner utføres automatisk ved oppstart.

Trinn 4. Første pålogging

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

http://localhost:8781/

På en tom database en pålogging admin blir opprettet og startpassordet skrives til ~/.aihummer/etc/initial-admin-password.txt. Les det, logg inn, så endre passordet og slette filen umiddelbart — steg for steg inn Første pålogging.

Trinn: opprett din første agent

Dette trinnet deles av skyen og selvhostet. Åpne i nettadmin-UI “Agenter” → “+ Skap”, sett et navn, en persona (systemprompt) og, eventuelt, en dedikert modell. Du vil se den nye agenten som en flis i listen. Full detalj, med karakter- og atferdstilpasning: Agenter.

Trinn: koble til din første kanal

For å la meldinger nå AiHummer, legg til en kanal:

  • Telegram — den mest produksjonsklare koblingen; en gjennomgang fra start til slutt “fra BotFather til den første meldingen” er i Telegram.
  • Økter i nettgrensesnitt — den raskeste måten å teste en agent på før man kobler til en ekstern kanal.
  • MAKS — en russisk budbringer, også tilgjengelig.

Konnektoren er installert på Plugins/Markedsplass skjerm, deretter konfigurert på Kanaler skjerm, hvor Bindinger blokker som angir hvilken agent som kjører den kanalen. Send en melding til kanalen og se en tur flyte fra start til slutt.

Snakk med agenten direkte fra administrasjonsgrensesnittet

En kanal er ikke nødvendig for en første test: på Økter siden «+ Ny økt»-knappen åpner en chat med en agent rett inne i admin-grensesnittet. I komponisten kan du legg ved filer (bilder og dokumenter — modellen mottar den uttrukne teksten), og to brytere over tråden avslører kostnad per tur og verktøyutgang — praktisk for å se hva agenten gjorde på hvert trinn.

[!TIP] Du kan også ringe AiHummer direkte via dets OpenAI-kompatible API uten kanal i det hele tatt:

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

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

Sett "stream": true for SSE-strømming.

Husk den falske modellen

Inntil du kobler til en ekte modell, kommer svarene fra en deterministisk mock — praktisk for å teste kanaler, ruting og agenter uten modellkostnad. Hvordan koble til en ekte leverandør (OpenAI, Anthropic, YandexGPT, GigaChat, Codex via et ChatGPT-abonnement og mer) er på Modeller side.

[!NOTE] En ekte modell er aldri obligatorisk: AiHummer kjører på gratis/lokalt OpenAI-kompatible endepunkter og en Codex/ChatGPT-abonnements transport.

Hvis det ikke fungerte

  • Installasjonskommandoen mislyktes — sjekk at du kjører det på Linux x86_64/arm64 og at den personlige lenken ikke er utdatert (den varer i 30 dager; få en ny på «Installer»-skjerm). Diagnostikk: Installasjon.
  • Administrasjonsgrensesnittet vil ikke åpne — nettlesergrensesnittet lytter på den private porten :8781, ikke offentlig :8780. Sjekk tjenesten: systemctl status aihummer-gateway.
  • Kan ikke finne det opprinnelige passordet — det er i ~/.aihummer/etc/initial-admin-password.txt, ikke i loggene. Se Første pålogging.
  • Skybetaling mislyktes — abonnementsstatusen på dashbordet viser årsak; prøv igjen, eller (for selskaper) velg betaling på 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 avsenderen er kjent for systemet (ved standard svarer agenten bare kjente brukere), se Kanaler.

Hvor til neste