Schnellstart
Dieses Schnellstart-Tutorial führt Sie durch Ihren ersten AiHummer-Durchlauf — von null bis zu einem ersten Agenten, der in einem Kanal antwortet. Es ist für jemanden geschrieben, der dies zum ersten Mal macht. erstes Mal: jeder Schritt endet mit was du sehen solltest, und es gibt am Ende einen Abschnitt „Wenn es nicht funktioniert hat“.
Zuerst wähle deinen Weg
Es gibt zwei Wege, AiHummer zu bekommen (voller Vergleich in der Einführung):
- Wolke — wir betreiben den Server, Sie erhalten eine fertige Adresse. Nichts zu installieren. → gehen zu Pfad A: Wolke.
- Selbst gehostet (Ihr eigener Server) — Sie installieren AiHummer auf Ihrem Linux-Server mit einem Befehl. → gehen zu Pfad B: Ihr eigener Server.
Beide Wege führen dann zu den gemeinsamen Schritten — erster Agent und erster Kanal.
Pfad A: Wolke
Was Sie benötigen: E-Mail-Adresse und Telefonnummer. Eine verfügbare Testphase erfordert weder Karte noch Prüfabbuchung; für die kostenpflichtige Fortsetzung ist eine Zahlung nötig.
- Registrieren bei my.aihummer.ru: geben Sie Ihre E-Mail, Telefonnummer ein und Passwort, akzeptiere die zwei Zustimmungen. Du wirst sehen die Kontobestätigung Bildschirm.
- Bestätigen Sie das Konto — per Anruf (geben Sie die letzten Ziffern der eingehenden Nummer ein) oder mit dem Code aus der E-Mail. Du wirst sehen, dass die Anmeldung automatisch erfolgt ist und der Einrichtungsassistent wurde geöffnet. Details: Registrierung & Anmeldung.
- Wählen Sie im Assistenten die Wolke Pfad, dann ein Plan (monatlich/jährlich).
Die erste Testphase für Personal Helper (
cloud-personal) dauert 14 Tage, ohne Bankkarte oder Prüfabbuchung. Sie ist einmal verfügbar. Andere Tarife bieten nur dann eine Testphase, wenn der ausgewählte Billing-Tarif sie ausdrücklich enthält; Unternehmenstarife enthalten keine. Für die weitere Nutzung ist eine Zahlung erforderlich; der Test aktiviert keine automatischen Abbuchungen. Die Testphase gilt nur für Konten ohne früheres Cloud-Abonnement; sie nutzt eine gemeinsame VM ohne dedizierte VM oder kostenpflichtige Zusatzoptionen. Pläne. - Für die Rechnungszahlung hinterlegen Sie die Unternehmensdaten im Profil. Eine Bestätigung durch den Betreiber ist nicht erforderlich; bei Kartenzahlung oder verfügbarer Testphase entfällt dieser Schritt.
- Wähle eine Subdomain-Name (Ihre Adresse wird
<name>.cloud.aihummer.ru) und starten Sie die verfügbare Testphase oder bezahlen Sie die Bestellung. Sie werden den Status “Vorbereitung Ihres Assistenten” mit Fortschritt sehen. Details: Bestellung & Zahlung. - Warten Sie auf die Bereitstellung (normalerweise ein paar Minuten). Wenn sich der Status ändert Dein Assistent läuft, klicken Panel öffnen — die Web-Admin-Oberfläche Ihres Instanz öffnet. Details: Instanz-Dashboard.
Die Konfiguration wird in der Web-Admin-Benutzeroberfläche fortgesetzt – gehen Sie zu Ihrem erster Agent. Das Administratorpasswort für eine Cloud-Instanz wird festgelegt, wenn Sie das Panel zum ersten Mal öffnen (die separate Passwortdatei, die bei selbstgehosteten Installationen verwendet wird, wird hier nicht benötigt).
Pfad B: Ihr eigener Server
Was Sie benötigen: ein Linux-Server (x86_64 oder arm64), sudo Rechte und PostgreSQL (oder lassen Sie den Installer es bereitstellen). Vollständige Liste: Anforderungen.
Schritt 1. Holen Sie sich Ihren persönlichen Installationslink
Es gibt kein öffentliches Installationsskript — der Link ist persönlich. Registrieren bei my.aihummer.ru, öffne das Installieren Bildschirm und klicken Sie auf „Meinen persönlichen Installationslink erhalten“. Sie werden sehen einen fertigen Befehl mit einer Kopier-Schaltfläche.
Schritt 2. Mit einem Befehl installieren
Führe den kopierten Befehl auf dem Server aus:
curl -fsSL -o install.sh "<your personal install link>" && sudo bash install.sh
Der Installer erkennt die Architektur, lädt herunter und überprüft das signierte Paket, legt das Installations-Stammverzeichnis fest bei ~/.aihummer und registriert den Gateway-Dienst unter systemd. Sie werden das Installationsprotokoll sehen und am Ende eine Nachricht über den gestarteten Dienst. Vollständige Details (Release-Kanäle, Sidecars, Rootless-Installation): Installation.
Schritt 3. Auf PostgreSQL zeigen
Die einzige harte Abhängigkeit ist PostgreSQL mit dem pgcrypto Erweiterung. Der Installer verbindet die Verbindung für Sie; um die Datenbank manuell einzustellen, verwenden Sie die AIHUMMER_DATABASE_URL Konfigurationsoption:
AIHUMMER_DATABASE_URL=postgres://user:pass@localhost:5432/aihummer?sslmode=disable
-- once, in the target database
CREATE EXTENSION IF NOT EXISTS pgcrypto;
Datenbankmigrationen werden beim Start automatisch angewendet.
Schritt 4. Erster Login
Weboberfläche, Apps und Kanäle verwenden dieselbe öffentliche Serveradresse. Öffnen Sie die vom Installer angezeigte öffentliche Adresse; lokal gilt standardmäßig http://localhost:8780/. Der bei der Installation gewählte Port kann abweichen.
http://localhost:8780/
Melden Sie sich mit dem im Installationsassistenten gewählten Administratornamen und Passwort an. Wurden stattdessen Anfangszugangsdaten automatisch erzeugt, verwenden Sie die abschließende Übersicht; die private Datei etc/initial-admin-password.txt gehört nur zu diesem Erstsetup. Geben Sie Zugangsdaten nicht weiter.
Schritt: Erstellen Sie Ihren ersten Agenten
Dieser Schritt wird von Cloud und selbst gehostet geteilt. Öffnen Sie in der Web-Admin-Oberfläche Agenten → + Erstellen, geben Sie einen Namen, eine Persona (Systemaufforderung) und optional ein spezielles Modell ein. Sie werden den neuen Agenten als Kachel in der Liste sehen. Vollständige Details, mit Charakter- und Verhaltenseinstellung: Agenten.
Schritt: Verbinden Sie Ihren ersten Kanal
Um Nachrichten AiHummer erreichen zu lassen, füge einen Kanal hinzu:
- Telegram — der produktionsbereiteste Connector; ein vollständiger Durchgang “von BotFather bis zur ersten Nachricht” ist in Telegram.
- Sitzungen in der Web-Benutzeroberfläche — die schnellste Methode, einen Agenten zu testen, bevor man eine Verbindung herstellt externer Kanal.
- MAX — auch ein russischer Bote verfügbar.
Der Anschluss ist auf dem installiert Plugins/Marktplatz Bildschirm, dann auf dem konfiguriert Kanäle Bildschirm, wo die Bindungen Blockiert, welcher Agent diesen Kanal betreibt. Senden Sie eine Nachricht an den Kanal und beobachten Sie, wie ein Durchgang von Anfang bis Ende verläuft.
Sprechen Sie direkt über die Admin-Benutzeroberfläche mit dem Agenten
Ein Kanal ist für einen ersten Test nicht erforderlich: auf der Sitzungen Seite Die Schaltfläche „Neue Sitzung“ öffnet einen Chat mit einem Agenten direkt innerhalb der Admin-Benutzeroberfläche. Im Composer können Sie Dateien anhängen (Bilder und Dokumente — das Modell erhält den extrahierten Text), und zwei Schalter oberhalb des Threads zeigen Kosten pro Zug und Werkzeugausgabe — praktisch, um zu sehen, was der Agent bei jedem Schritt gemacht hat.
[!TIP] Sie können AiHummer auch direkt über seine OpenAI-kompatible API ohne überhaupt Kanal:
POST /v1/chat/completions Content-Type: application/json {"model": "default", "messages": [{"role": "user", "content": "Hello"}]}Set
"stream": truefür SSE-Streaming.
Modelle
[!NOTE] Verbinden Sie einen echten Modellanbieter, um nutzbare Antworten zu erhalten. Ein kostenpflichtiger API-Schlüssel ist nicht erforderlich: Nutzen Sie ein lokales OpenAI-kompatibles Modell, ein unterstütztes Abonnement oder Ihren eigenen API-Schlüssel. Modelle · BYOK- und LLM-Anbieter
Wenn es nicht funktioniert hätte
- Der Installationsbefehl ist fehlgeschlagen — überprüfen Sie, dass Sie es auf Linux x86_64/arm64 ausführen und dass der persönliche Link nicht veraltet ist (er lebt 30 Tage; besorgen Sie sich einen neuen auf der “Installations”-Bildschirm). Diagnostik: Installation.
- Weboberfläche, Apps und Kanäle verwenden dieselbe öffentliche Serveradresse. Öffnen Sie die vom Installer angezeigte öffentliche Adresse; lokal gilt standardmäßig
http://localhost:8780/. Der bei der Installation gewählte Port kann abweichen. - Kann das Anfangspasswort nicht finden — es ist drin
~/.aihummer/etc/initial-admin-password.txt(nur wenn die Anfangszugangsdaten automatisch erzeugt wurden), nicht in den Protokollen. Siehe Erste Anmeldung. - Cloud-Zahlung fehlgeschlagen — der Abonnementstatus auf dem Dashboard zeigt die Grund; erneut versuchen oder (für Unternehmen) Rechnungszahlung wählen, siehe Bestellung & Zahlung.
- Der Agent antwortet nicht in einem Kanal — stelle sicher, dass der Kanal an einen gebunden ist Agent im „Bindings“-Block, und dass der Absender dem System bekannt ist (durch Standardmäßig antwortet der Agent nur auf bekannte Benutzer), siehe Kanäle.
Wohin als Nächstes
- Produktions-Selbsthosting-Bereitstellung: Installation.
- Verhalten über die Benutzeroberfläche anpassen: Konfiguration.
- Sichern Sie die erste Anmeldung: Erste Anmeldung.
- Verbinden Sie ein Modell: Modelle.