AiHummer
Deutsch▾
AnmeldenKonto
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Erste Schritte/Schnellstart

Schnellstart

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

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: eine E-Mail-Adresse, eine Telefonnummer und eine Bankkarte (für die Testversion belastet die Bank 1 ₽ und erstattet ihn sofort).

  1. 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.
  2. 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.
  3. Wählen Sie im Assistenten die Wolke Pfad, dann ein Plan (monatlich/jährlich). Die Eintrittsplan wird mit einem geliefert 10-tägige kostenlose Testversion. Details: Pläne.
  4. Füllen Sie Ihr Rechnungsdaten (Einzelperson oder Unternehmen/Einzelunternehmer) — sie werden für die Rechnung und die Handlung benötigt.
  5. Wähle eine Subdomain-Name (Ihre Adresse wird <name>.cloud.aihummer.ru) und bezahlen. Sie werden den Status “Vorbereitung Ihres Assistenten” mit Fortschritt sehen. Details: Bestellung & Zahlung.
  6. 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.

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

Sobald der Dienst läuft, öffnen Sie die Admin-Weboberfläche auf dem Server (privater Port) :8781 standardmäßig):

http://localhost:8781/

Bei einer leeren Datenbank ein Login admin wird erstellt und das Anfangspasswort wird geschrieben an ~/.aihummer/etc/initial-admin-password.txt. Lies es, melde dich an, dann Ändere das Passwort und lösche die Datei sofort — Schritt für Schritt hinein Erste Anmeldung.

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": true für SSE-Streaming.

Erinnere dich an das Scheinmodell

Bis Sie ein echtes Modell verbinden, kommen die Antworten von einem deterministisches Mock — praktisch zum Testen von Kanälen, Routing und Agenten ohne Modellkosten. Wie man einen echten Anbieter (OpenAI, Anthropic, YandexGPT, GigaChat, Codex über ein ChatGPT-Abonnement und mehr) verbindet, steht auf der Modelle Seite.

[!NOTE] Ein echtes Modell ist niemals obligatorisch: AiHummer läuft auf frei/lokal OpenAI-kompatible Endpunkte und ein Codex/ChatGPT-Abonnement-Transport.

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.
  • Die Admin-Benutzeroberfläche lässt sich nicht öffnen — die Web-Benutzeroberfläche lauscht auf dem privaten Port :8781, nicht die Öffentlichkeit :8780. Überprüfen Sie den Service: systemctl status aihummer-gateway.
  • Kann das Anfangspasswort nicht finden — es ist drin ~/.aihummer/etc/initial-admin-password.txt, 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