Démarrage rapide
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 et un numéro de téléphone. L’essai éligible ne nécessite ni carte ni prélèvement de vérification; un paiement est nécessaire pour continuer sur une offre payante.
- 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 premier essai Personal Helper (
cloud-personal) dure 14 jours, sans carte bancaire ni prélèvement de vérification. Il est disponible une seule fois. Les autres offres ne proposent un essai que si le forfait Billing choisi le prévoit explicitement; les offres pour entreprises ne comprennent pas cet essai. Un paiement est nécessaire pour continuer; cet essai n’active aucun prélèvement automatique. L’essai est réservé aux comptes sans abonnement cloud antérieur; il utilise une VM partagée, sans VM dédiée ni options payantes. Plans. - Pour payer sur facture, renseignez les coordonnées de l’entreprise dans le profil. Aucune validation par un opérateur n’est requise; le paiement par carte et l’essai éligible ne nécessitent pas cette étape.
- Choisis un nom de sous-domaine (votre adresse sera
<name>.cloud.aihummer.ru) et démarrez l’essai disponible ou payez la commande. 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
Le panneau web, les applications et les canaux partagent une seule adresse publique du serveur. Ouvrez l’adresse publique indiquée par l’installateur ; l’adresse locale par défaut est http://localhost:8780/. Le port choisi pendant l’installation peut différer.
http://localhost:8780/
Connectez-vous avec l’identifiant et le mot de passe administrateur choisis dans l’assistant d’installation. Si des identifiants initiaux ont été générés automatiquement, utilisez le récapitulatif final ; le fichier privé etc/initial-admin-password.txt concerne uniquement cette initialisation. Ne partagez pas les identifiants.
É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": truepour le streaming SSE.
Modèles
[!NOTE] Connectez un véritable fournisseur de modèles pour obtenir des réponses utiles. Une clé API payante n’est pas obligatoire : utilisez un modèle local compatible OpenAI, un abonnement pris en charge ou votre propre clé API. Modèles · Fournisseurs BYOK et LLM
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.
- Le panneau web, les applications et les canaux partagent une seule adresse publique du serveur. Ouvrez l’adresse publique indiquée par l’installateur ; l’adresse locale par défaut est
http://localhost:8780/. Le port choisi pendant l’installation peut différer. - Impossible de trouver le mot de passe initial — c’est dans
~/.aihummer/etc/initial-admin-password.txt(uniquement si les identifiants initiaux ont été générés automatiquement), 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.