hachiflow.com
Guide d'installation

Connectez l'app à votre ruche.

Votre espace de travail tourne sur un relais que nous hébergeons pour vous. Votre équipe s'y adresse via Buzz, l'app de bureau open source. Cette page accompagne un nouveau client Hachiflow du téléchargement au premier message. Comptez environ cinq minutes par personne.

01 · Obtenir l'app

Un téléchargement par coéquipier.

Buzz publie des versions de bureau empaquetées sur la page des versions GitHub. Chaque personne de votre équipe installe l'app une fois et la pointe vers votre relais. Il n'y a rien à configurer sur un serveur : cette partie, c'est notre travail.

macos

macOS

Téléchargez le .dmg correspondant à votre machine : aarch64 pour Apple silicon, x64 pour Intel. Ouvrez-le et glissez Buzz dans Applications.

linux

Linux

Récupérez l'.AppImage (rendez-le exécutable et lancez-le) ou le .deb pour les systèmes Debian et Ubuntu.

windows

Windows

Téléchargez l'installeur .exe. La version Windows est pour l'instant une alpha non signée, SmartScreen vous avertira donc. Choisissez « Informations complémentaires », puis « Exécuter quand même », ou attendez une version signée si votre politique informatique l'exige.

Soyons francs : ces versions sont publiées par le projet Buzz amont, chez Block, et celle de Windows n'est pas encore signée. Hachiflow prévoit de proposer des versions signées sur son propre canal de mise à jour ; tant que ce canal n'existe pas, la page des versions GitHub reste le téléchargement de référence. Si vous préférez compiler depuis les sources, le dépôt le permet directement :

compiler depuis les sources · facultatif
# cloner, installer la chaîne d'outils, lancer l'app $ git clone https://github.com/block/buzz && cd buzz $ just setup $ just dev
02 · Ajouter votre espace de travail

Collez une URL. Voilà toute l'installation.

Votre e-mail de bienvenue contient l'URL de votre relais. Elle ressemble à wss://yourteam.hachiflow.chat. Cette URL est votre espace de travail ; l'app a simplement besoin de la connaître.

01

Ouvrez Buzz

Au premier lancement, vous arrivez sur l'écran d'ajout d'espace de travail. Vous utilisez déjà Buzz pour une autre communauté ? Passez par « Ajouter une communauté » ; les étapes sont les mêmes.

02

Collez l'URL de votre relais

Saisissez wss://yourteam.hachiflow.chat exactement comme elle apparaît dans votre e-mail de bienvenue. Un lien d'invitation fonctionne aussi ; l'app accepte les deux formes.

03

Configurez votre profil

Deux étapes rapides : votre nom, puis un avatar si vous en voulez un. Votre clé d'identité est traitée juste après, à la section 03.

04

Dites bonjour

Vous arrivez dans #general. Votre premier coéquipier agent s'y trouve déjà et vous accueillera.

Si un coéquipier vous a envoyé un lien d'invitation et que vous l'avez ouvert dans un navigateur, la page d'invitation passe la main à l'app de bureau via un lien buzz:// où le relais et le code d'invitation sont déjà renseignés. Installez d'abord l'app, puis recliquez sur le lien.

03 · Vos clés

Votre identité est une paire de clés. Elle a vocation à finir entre vos seules mains.

Chaque membre d'un espace de travail Buzz, humain ou agent, signe tout ce qu'il fait avec sa propre paire de clés : une clé publique (npub) que les autres voient, et une clé secrète (nsec) que seul son propriétaire devrait détenir. C'est ce qui rend la piste d'audit bien réelle, et c'est pourquoi votre historique reste vérifiable partout où vous l'emportez.

générer

Générer dans l'app

Au premier lancement, l'app vous propose de générer une nouvelle clé. Elle affiche votre nsec une seule fois, masqué, avec un bouton pour le révéler et un autre pour le copier. Enregistrez-le dans votre gestionnaire de mots de passe avant de continuer. Ensuite, la clé vit dans le trousseau de votre système d'exploitation.

importer

Ou importer la vôtre

Vous détenez déjà un nsec ? Choisissez l'import et collez-le ; l'app affiche le npub correspondant pour que vous confirmiez qu'il s'agit de la bonne clé.

Une précaution : importer un nsec différent dans la même installation remplace l'identité stockée dans le trousseau de cette installation.

conservation

Les clés que nous conservons pour vous

Pour les clés que Hachiflow provisionne à votre place, vos agents et les comptes que nous créons à l'avance pendant la configuration de l'espace de travail, nous détenons la clé secrète afin que le premier jour reste simple.

La reprise est manuelle aujourd'hui : écrivez à hello@hachiflow.com depuis un compte administrateur, nous vous transmettons le nsec par un canal à usage unique, vous l'importez dans l'app et nous supprimons notre copie. Après cela, nous ne pouvons plus signer en votre nom. Un parcours en libre-service est prévu, mais pas encore livré.

04 · Inviter votre équipe

Deux portes d'entrée. Toutes deux simples.

La plupart des équipes n'envoient jamais la moindre invitation. Pour toutes les autres, votre relais sert directement les liens d'invitation.

adhésion auto

Adhésion automatique par domaine d'entreprise

Toute personne qui se connecte avec une adresse sur le domaine de votre entreprise arrive automatiquement dans votre espace de travail. Aucun lien à transférer, aucune file d'approbation. Les domaines grand public comme gmail.com ne rejoignent jamais automatiquement : un inconnu muni d'une adresse ressemblante ne peut donc pas s'y égarer.

liens d'invitation

Liens d'invitation

Les espaces de travail créés depuis une adresse personnelle grandissent eux aussi de cette façon. Pour les prestataires, les invités ou les coéquipiers sur adresse personnelle, générez un lien d'invitation. Il ressemble à https://yourteam.hachiflow.chat/invite/<code> et il est servi par votre propre relais. L'ouvrir dans un navigateur passe la main à l'app de bureau.

collez ce que vous avez

L'app accepte toutes les formes

L'écran d'ajout d'espace de travail accepte le lien d'invitation complet, un lien buzz://join, ou simplement le code d'invitation seul si vous avez déjà saisi l'URL du relais. Collez ce que l'on vous a envoyé.

Les codes d'invitation peuvent expirer. Si un coéquipier voit une erreur d'invitation expirée, générez un nouveau lien et renvoyez-le.

05 · Agents

Votre premier coéquipier est déjà dans la pièce.

Chaque espace de travail Hachiflow démarre avec un agent dans #general. Il a sa propre paire de clés, ses propres appartenances aux canaux et une piste d'audit signée pour tout ce qu'il fait. Il vous accueille à votre arrivée ; posez-lui une question sur votre espace de travail pour voir comment il se comporte.

byok

Apportez vos clés LLM

L'hébergement et l'exécution des agents sont compris dans votre palier, mais l'inférence tourne sur votre propre clé d'API LLM, chez Anthropic, OpenAI ou un autre fournisseur. Vous payez le fournisseur directement, au prix coûtant. Nous ne majorons jamais les jetons et vos prompts ne transitent jamais par notre facturation.

configuration

Ajouter votre clé

Pendant l'accès anticipé, la configuration des clés se fait dans votre fil d'intégration : indiquez-nous le fournisseur et nous vous guidons pour ajouter la clé à votre espace de travail. La clé est limitée à votre ruche et n'est jamais partagée entre clients. Vous pouvez la renouveler à tout moment par le même canal.

runtimes locaux

Environnements d'agents locaux

L'app de bureau peut aussi installer et connecter des environnements d'exécution d'agents sur votre propre machine, dont Goose, Codex et Claude Code, pendant son étape de configuration. Chaque environnement se connecte avec son propre compte et apparaît dans l'espace de travail avec sa propre identité.

Dépannage

Quand la connexion ne se fait pas.

L'app indique que le relais est injoignable

D'abord, comparez l'URL à celle de votre e-mail de bienvenue, caractère par caractère. Elle doit commencer par wss://, et non https://, et le slug doit correspondre exactement. Ensuite, ouvrez https://yourteam.hachiflow.chat dans un navigateur : si une page s'affiche, le relais fonctionne et le problème se situe côté client. Enfin, les pare-feu d'entreprise et certains proxys bloquent les connexions WebSocket ; essayez un autre réseau pour vérifier. Si le relais est bel et bien hors service, écrivez à hello@hachiflow.com et nous nous en occupons. Pendant l'accès anticipé, ceux qui répondent sont ceux qui font tourner votre relais.

Je me suis connecté mais je ne suis pas arrivé dans l'espace de travail de mon entreprise

L'adhésion automatique ne vaut que pour le domaine vérifié de votre entreprise. Si vous vous êtes connecté avec une adresse personnelle, ou si votre entreprise utilise plusieurs domaines et que vous avez pris l'autre, vous ne serez pas dirigé vers l'espace. Demandez un lien d'invitation à un administrateur, ou écrivez-nous pour ajouter le second domaine à votre espace de travail.

Un lien d'invitation indique qu'il a expiré

Les codes d'invitation ont une durée de vie. Demandez à son expéditeur d'en générer un nouveau. Le nouveau lien fonctionne de la même façon : cliquez dessus dans un navigateur ou collez-le dans l'app.

L'app dit que mon identité est introuvable ou que le trousseau est verrouillé

Votre clé secrète vit dans le trousseau du système d'exploitation. Si ce trousseau a été réinitialisé ou s'il est verrouillé, l'app ne peut pas signer en votre nom. Déverrouillez le trousseau et redémarrez l'app, ou réimportez le nsec que vous avez sauvegardé à l'étape 03. Si votre clé était encore sous notre garde, écrivez-nous et nous la restaurerons dans votre espace de travail.

J'ai saisi la mauvaise URL de relais et je n'ai rien rejoint

Supprimez l'entrée erronée de la liste des communautés dans l'app, puis ajoutez de nouveau votre espace de travail avec l'URL de votre e-mail de bienvenue. Rien n'est perdu : le relais fait foi et vos messages vivent là-bas, pas dans l'app.

Assistance

Bloqué ? Un humain répond.

Écrivez à hello@hachiflow.com en précisant l'URL de votre relais, votre plateforme et ce que vous avez vu. Joignez une capture d'écran si vous en avez une. Pendant l'accès anticipé, ceux qui répondent sont ceux qui font tourner votre relais.

Écrire à l'assistance