Snabbstart
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: E-postadress och telefonnummer. En tillgänglig provperiod kräver varken kort eller kontrollavgift; betald fortsättning kräver betalning.
- 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.
- 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.
- I guiden välj Moln stig, sedan en plan (månatlig/årlig).
Den första provperioden för Personal Helper (
cloud-personal) varar 14 dagar utan bankkort eller kontrollavgift. Den erbjuds en gång. Andra planer har provperiod endast om den valda Billing-planen uttryckligen innehåller det; företagsplaner gör inte det. Betalning krävs för att fortsätta; provperioden aktiverar inga automatiska debiteringar. Provperioden gäller endast konton utan tidigare molnabonnemang; en delad VM används utan dedikerad VM eller betalda tillägg. Planer. - För fakturabetalning fyller du i företagets uppgifter i profilen. Operatörens godkännande krävs inte; kortbetalning och en tillgänglig provperiod kräver inte detta steg.
- Välj en subdomännamn (din adress kommer att vara
<name>.cloud.aihummer.ru) och starta tillgänglig provperiod eller betala beställningen. Du kommer att se statusen “Förbereder din assistent” med framsteg. Detaljer: Beställning och betalning. - 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
Webbpanelen, appar och kanaler använder samma offentliga serveradress. Öppna den offentliga adress som installationsprogrammet visar; lokal standardadress är http://localhost:8780/. Porten som valdes vid installationen kan vara en annan.
http://localhost:8780/
Logga in med administratörsnamnet och lösenordet som valdes i installationsguiden. Om inledande uppgifter skapades automatiskt använder du slutsammanfattningen; den privata filen etc/initial-admin-password.txt gäller bara den grundinställningen. Dela inte inloggningsuppgifterna.
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": trueför SSE-strömning.
Modeller
[!NOTE] Anslut en riktig modellleverantör för att få användbara svar. En betald API-nyckel krävs inte: använd en lokal OpenAI-kompatibel modell, en stödd prenumeration eller din egen API-nyckel. Modeller · BYOK och LLM-leverantörer
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.
- Webbpanelen, appar och kanaler använder samma offentliga serveradress. Öppna den offentliga adress som installationsprogrammet visar; lokal standardadress är
http://localhost:8780/. Porten som valdes vid installationen kan vara en annan. - Kan inte hitta det ursprungliga lösenordet — det är i
~/.aihummer/etc/initial-admin-password.txt(endast om de ursprungliga inloggningsuppgifterna skapades automatiskt), 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
- Produktionsdistribution med egen värd: Installation.
- Justera beteende från användargränssnittet: Konfiguration.
- Säkra den första inloggningen: Första inloggningen.
- Anslut en modell: Modeller.