Démarrage rapide — AiHummer Docs

Ce guide de démarrage rapide vous guide à travers votre première utilisation d’AiHummer — de zéro à un premier agent répondant dans un canal. Il est écrit pour quelqu’un qui le fait pour le première fois: chaque étape se termine par ce que vous devriez voir, et il y a une section « Si cela n’a pas fonctionné » à la fin.

D’abord, choisis ton chemin

Il y a deux façons d’obtenir AiHummer (comparaison complète dans le Introduction):

Nuage — nous gérons le serveur, vous obtenez une adresse prête. Rien à installer. → aller à Chemin A : nuage.
Auto-hébergé (votre propre serveur) — vous installez AiHummer sur votre serveur Linux avec une seule commande. → aller à Chemin B : votre propre serveur.

Les deux chemins convergent alors vers les étapes communes — premier agent et première chaîne.

Chemin A : nuage

Ce dont vous aurez besoin : une adresse e-mail, un numéro de téléphone et une carte bancaire (pour l’essai, la banque prélève 1 ₽ et le rembourse immédiatement).

S’inscrire à my.aihummer.ru: entrez votre e-mail, téléphone et le mot de passe, acceptez les deux consentements. Vous verrez la confirmation du compte écran.
Confirmez le compte — par appel (entrez les derniers chiffres du numéro entrant) ou avec le code de l’e-mail. Vous verrez que la connexion s’est faite automatiquement et l’assistant d’intégration s’est ouvert. Détails : Inscription et connexion.
Dans l’assistant, choisissez le Nuage chemin, puis un plan (mensuel/annuel). Le le plan d’entrée vient avec un Essai gratuit de 10 jours. Détails : Plans.
Remplissez votre détails de facturation (particulier ou entreprise/propriétaire unique) — ils sont nécessaires pour la facture et l’acte.
Choisis un nom de sous-domaine (votre adresse sera <name>.cloud.aihummer.ru) et payer. Vous verrez le statut « Préparation de votre assistant » avec la progression. Détails : Commande et paiement.
Attendez la mise à disposition (généralement quelques minutes). Lorsque le statut devient Votre l’assistant fonctionne, cliquer Ouvrir le panneau — l’interface d’administration web de votre instance s’ouvre. Détails : Tableau de bord de l’instance.

La configuration se poursuit dans l’interface d’administration web — allez à votre premier agent. Le mot de passe administrateur pour une instance cloud est défini lorsque vous ouvrez le panneau pour la première fois (le fichier de mot de passe séparé utilisé dans l’auto-hébergement n’est pas nécessaire ici).

Chemin B : votre propre serveur

Ce dont vous aurez besoin : un serveur Linux (x86_64 ou arm64), sudo droits, et PostgreSQL (ou laissez l’installateur le configurer). Liste complète : Exigences.

Étape 1. Obtenez votre lien d’installation personnel

Il n’y a pas de script d’installation public — le lien est personnel. Inscrivez-vous à my.aihummer.ru, ouvrez le Installer écran et cliquez sur « Obtenir mon lien d’installation personnel ». Vous verrez une commande prête avec un bouton de copie.

Étape 2. Installer avec une commande

Exécutez la commande copiée sur le serveur :

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

L’installateur détecte l’architecture, télécharge et vérifie le paquet signé, définit le répertoire d’installation à ~/.aihummer et enregistre le service de passerelle sous systemd. Vous verrez le journal de l’étape d’installation et, à la fin, un message indiquant que le service a démarré. Détails complets (canaux de diffusion, sidecars, installation sans droits root) : Installation.

Étape 3. Pointez sur PostgreSQL

La seule dépendance obligatoire est PostgreSQL avec le pgcrypto extension. L’installateur branche la connexion pour vous ; pour configurer la base de données manuellement, utilisez le AIHUMMER_DATABASE_URL option de configuration :

AIHUMMER_DATABASE_URL=postgres://user:pass@localhost:5432/aihummer?sslmode=disable

-- once, in the target database
CREATE EXTENSION IF NOT EXISTS pgcrypto;

Les migrations de base de données s’appliquent automatiquement au démarrage.

Étape 4. Première connexion

Une fois le service en marche, ouvrez l’interface Web d’administration sur le serveur (port privé) :8781 par défaut) :

http://localhost:8781/

Sur une base de données vide, une connexion admin est créé et le mot de passe initial est écrit sur ~/.aihummer/etc/initial-admin-password.txt. Lisez-le, connectez-vous, puis changer le mot de passe et supprimer le fichier immédiatement — étape par étape dans Première connexion.

Étape : créez votre premier agent

Cette étape est partagée par le cloud et l’auto-hébergement. Dans l’interface web d’administration, ouvrez Agents → + Créer, définissez un nom, une personnalité (invite du système) et, éventuellement, un modèle dédié. Vous verrez le nouvel agent comme une vignette dans la liste. Détails complets, avec réglage du caractère et du comportement : Agents.

Étape : connectez votre premier canal

Pour permettre aux messages d’atteindre AiHummer, ajoutez un canal :

Télégramme — le connecteur le plus prêt pour la production ; un guide complet de bout en bout “de BotFather au premier message” est dans Télégramme.
Sessions dans l’interface Web — le moyen le plus rapide de tester un agent avant de le connecter à un canal externe.
MAX — un messager russe, également disponible.

Le connecteur est installé sur le Plugins/Marché écran, puis configuré sur le Chaînes écran, où le Liens bloquez les ensembles qui agent exécute ce canal. Envoyez un message au canal et regardez un tour se dérouler de bout en bout.

Parlez à l’agent directement depuis l’interface d’administration

Un canal n’est pas nécessaire pour un premier test : sur le Sessions la page le bouton « Nouvelle session » ouvre une conversation avec un agent directement dans l’interface d’administration. Dans le compositeur, vous pouvez joindre des fichiers (images et documents — le modèle reçoit le texte extrait), et deux bascules au-dessus du fil révèlent coût par tour et sortie de l’outil — pratique pour voir ce que l’agent a fait à chaque étape.

[!TIP] Vous pouvez également appeler AiHummer directement via son API compatible OpenAI sans chaîne du tout :
POST /v1/chat/completions
Content-Type: application/json

{"model": "default", "messages": [{"role": "user", "content": "Hello"}]}
Ensemble "stream": true pour le streaming SSE.

Souviens-toi du modèle simulé

Jusqu’à ce que vous connectiez un vrai modèle, les réponses proviennent d’un simulation déterministe — pratique pour tester des canaux, le routage et les agents sans coût de modèle. Comment connecter un fournisseur réel (OpenAI, Anthropic, YandexGPT, GigaChat, Codex via un abonnement ChatGPT et plus) se trouve sur le Modèles page.

[!NOTE] Un vrai modèle n’est jamais obligatoire : AiHummer fonctionne sur gratuit/local Points de terminaison compatibles OpenAI et un transport par abonnement Codex/ChatGPT.

Si cela n’a pas fonctionné

La commande d’installation a échoué — vérifiez que vous l’exécutez sur Linux x86_64/arm64 et que le lien personnel n’est pas périmé (il est valable 30 jours ; obtenez-en un nouveau sur le Écran “Installation”). Diagnostics : Installation.
L’interface d’administration ne s’ouvrira pas — l’interface Web écoute sur le port privé :8781, pas le public :8780. Vérifiez le service : systemctl status aihummer-gateway.
Impossible de trouver le mot de passe initial — c’est dans ~/.aihummer/etc/initial-admin-password.txt, pas dans les journaux. Voir Première connexion.
Le paiement en ligne a échoué — le statut de l’abonnement sur le tableau de bord montre le raison ; réessayer, ou (pour les entreprises) choisir le paiement par facture, voir Commande et paiement.
L’agent ne répond pas dans un canal — assurez-vous que le canal est lié à un agent dans le bloc « Bindings », et que l’expéditeur est connu du système (par par défaut, l’agent ne répond qu’aux utilisateurs connus), voir Chaînes.

Où aller ensuite

Déploiement en production auto-hébergé : Installation.
Ajuster le comportement depuis l’interface utilisateur : Configuration.
Sécurisez la première connexion : Première connexion.
Connecter un modèle : Modèles.