AiHummer
Svenska▾
Logga inKonto
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Komma igång/Snabbstart

Snabbstart

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

Denna snabbstart tar dig igenom din första AiHummer-körning — från noll till en första agent som svarar i en kanal. Den är skriven för någon som gör detta för första gången: varje steg slutar med vad du borde se, och det finns en “Om det inte fungerade”-sektion i slutet.

Först, välj din väg

Det finns två sätt att få AiHummer (full jämförelse i Introduktion):

  • Moln — vi driver servern, du får en färdig adress. Inget att installera. → gå till Väg A: moln.
  • Självhostad (din egen server) — du installerar AiHummer på din Linux-server med ett kommando. → gå till Väg B: din egen server.

Båda vägarna konvergerar sedan på de gemensamma stegen — första agent och första kanalen.

Väg A: moln

Vad du behöver: en e-postadress, ett telefonnummer och ett bankkort (för provet debiterar banken ₽1 och återbetalar det omedelbart).

  1. Registrera dig på my.aihummer.ru: ange din e-post, telefon och lösenord, acceptera de två samtyckena. Du kommer att se konto-bekräftelsen skärm.
  2. Bekräfta kontot — via samtal (ange de sista siffrorna i det inkommande numret) eller med koden från e-postmeddelandet. Du kommer att se att inloggningen skedde automatiskt och onboarding-guiden öppnades. Detaljer: Registrering och inloggning.
  3. I guiden välj Moln stig, sedan en plan (månatlig/årlig). inträdesplan kommer med en 10 dagars gratis provperiod. Detaljer: Planer.
  4. Fyll i din faktureringsuppgifter (individ eller företag/enskild näringsidkare) — de behövs för fakturan och handlingen.
  5. Välj en subdomännamn (din adress kommer att vara <name>.cloud.aihummer.ru) och betala. Du kommer att se statusen “Förbereder din assistent” med framsteg. Detaljer: Beställning och betalning.
  6. Vänta på provisioning (vanligtvis några minuter). När statusen ändras Din assistenten körs, klicka Öppna panel — webbadmingränssnittet för din instansen öppnas. Detaljer: Instansinstrumentpanel.

Konfigurationen fortsätter i webbadministratörens gränssnitt — gå till din första agent. Administratörslösenordet för en molninstans ställs in när du först öppnar panelen (den separata lösenordsfilen som används i självhostade installationer behövs inte här).

Väg B: din egen server

Vad du behöver: en Linux-server (x86_64 eller arm64), sudo rättigheter, och PostgreSQL (eller låt installatören tillhandahålla det). Fullständig lista: Krav.

Steg 1. Få din personliga installationslänk

Det finns inget offentligt installationsskript — länken är personal. Registrera dig på my.aihummer.ru, öppna Installera skärmen och klicka på “Få min personliga installationslänk”. Du kommer att se ett färdigt kommando med en kopieringsknapp.

Steg 2. Installera med ett kommando

Kör det kopierade kommandot på servern:

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

Installationsprogrammet upptäcker arkitekturen, laddar ner och verifierar den signerade paketet, anger installationsrot vid ~/.aihummer och registrerar gateway-tjänsten under systemd. Du kommer att se loggen för installationssteget och, i slutet, ett meddelande om att tjänsten har startat. Fullständiga detaljer (release-kanaler, sidecars, rootless-installation): Installation.

Steg 3. Peka på PostgreSQL

Det enda hårda beroendet är PostgreSQL med pgcrypto tillägg. Installatören kopplar upp anslutningen åt dig; för att ställa in databasen manuellt, använd AIHUMMER_DATABASE_URL konfigurationsalternativ:

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

Databasöverföringar tillämpas automatiskt vid uppstart.

Steg 4. Första inloggning

När tjänsten är igång, öppna admin Web UI på servern (privat port) :8781 som standard):

http://localhost:8781/

På en tom databas en inloggning admin skapas och det initiala lösenordet skrivs till ~/.aihummer/etc/initial-admin-password.txt. Läs det, logga in, sedan byt lösenordet och radera filen omedelbart — steg för steg in Första inloggningen.

Steg: skapa din första agent

Detta steg delas av både moln och egenhostad. Öppna i webbadmin-UI “Agenter” → “+ skapa”, ange ett namn, en persona (systemprompt) och, eventuellt, en dedikerad modell. Du kommer att se den nya agenten som en ruta i listan. Fullständiga detaljer, med karaktärs- och beteendetuning: Agenter.

Steg: anslut din första kanal

För att låta meddelanden nå AiHummer, lägg till en kanal:

  • Telegram — den mest produktionsklara kontakten; en genomgång från början till slut “från BotFather till det första meddelandet” är i Telegram.
  • Sessioner i webbgränssnittet — det snabbaste sättet att testa en agent innan man kopplar en extern kanal.
  • MAX — en rysk budbärare, finns också tillgänglig.

Kontakten är installerad på Plugins/Marknadsplats skärm, sedan konfigurerad på Kanaler skärm, där “Bindningar” blockerar vilka agenter som kör den kanalen. Skicka ett meddelande till kanalen och se ett turflöde gå från början till slut.

Prata med agenten direkt från administrationsgränssnittet

En kanal krävs inte för ett första test: på “Sessioner” sidan öppnar knappen “Ny session” en chatt med en agent direkt i administrationsgränssnittet. I kompositören kan du bifoga filer (bilder och dokument — modellen tar emot den extraherade texten), och två växlar ovanför tråden avslöjar kostnad per tur och verktygsutdata — praktiskt för att se vad agenten gjorde vid varje steg.

[!TIP] Du kan också ringa AiHummer direkt över dess OpenAI-kompatibla API utan kanal alls:

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

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

Sätta "stream": true för SSE-strömning.

Kom ihåg modellprovet

Tills du ansluter en riktig modell, kommer svaren från en deterministisk mock — praktiskt för att testa kanaler, routing och agenter utan modellkostnad. Hur man ansluter en riktig leverantör (OpenAI, Anthropic, YandexGPT, GigaChat, Codex via en ChatGPT-prenumeration och mer) finns på Modeller sida.

[!NOTE] En riktig modell är aldrig obligatorisk: AiHummer körs på gratis/lokal OpenAI-kompatibla slutpunkter och en Codex/ChatGPT-prenumerationstransport.

Om det inte fungerade

  • Installationskommandot misslyckades — kontrollera att du kör det på Linux x86_64/arm64 och att den personliga länken inte är föråldrad (den gäller i 30 dagar; skaffa en ny på Installationsskärm). Diagnostik: Installation.
  • Administratörsgränssnittet öppnas inte — webbgränssnittet lyssnar på den privata porten :8781, inte allmänheten :8780. Kontrollera tjänsten: systemctl status aihummer-gateway.
  • Kan inte hitta det ursprungliga lösenordet — det är i ~/.aihummer/etc/initial-admin-password.txt, inte i loggarna. Se Första inloggningen.
  • Molnbetalning misslyckades — prenumerationsstatusen på instrumentpanelen visar orsak; försök igen, eller (för företag) välj fakturabetalning, se Beställning och betalning.
  • Agenten svarar inte i en kanal — se till att kanalen är kopplad till en agent i ”Bindings”-blocket, och att avsändaren är känd av systemet (av standard är att agenten endast svarar på kända användare), se Kanaler.

Vart härnäst