hachiflow.com
Guía de configuración

Conecte la app a su colmena.

Su espacio de trabajo corre sobre un relay que alojamos por usted. Su equipo se comunica con él a través de Buzz, la app de escritorio de código abierto. Esta página lleva a un cliente nuevo de Hachiflow de la descarga al primer mensaje. Suele tomar unos cinco minutos por persona.

01 · Obtener la app

Una descarga por persona.

Buzz publica versiones de escritorio empaquetadas en la página de releases de GitHub. Cada persona del equipo instala la app una vez y la apunta a su relay. No hay nada que configurar en un servidor; esa parte es trabajo nuestro.

macos

macOS

Descargue el .dmg de su equipo: aarch64 para Apple silicon, x64 para Intel. Ábralo y arrastre Buzz a Aplicaciones.

linux

Linux

Tome el .AppImage (hágalo ejecutable y ejecútelo) o el .deb para sistemas Debian y Ubuntu.

windows

Windows

Descargue el instalador .exe. La versión de Windows es hoy una alfa sin firmar, así que SmartScreen le mostrará una advertencia. Elija «Más información» y luego «Ejecutar de todas formas», o espere una versión firmada si su política de TI lo exige.

Hablemos claro: estas versiones las publica el proyecto original de Buzz en Block, y la de Windows todavía no está firmada. Hachiflow planea distribuir versiones firmadas por su propio canal de actualización; hasta que eso exista, la página de releases de GitHub es la descarga canónica. Si prefiere compilar desde el código fuente, el repositorio lo permite directamente:

compilar desde el código fuente · opcional
# clone, prepare las herramientas, ejecute la app $ git clone https://github.com/block/buzz && cd buzz $ just setup $ just dev
02 · Agregue su espacio de trabajo

Pegue una URL. Esa es toda la configuración.

Su correo de bienvenida contiene la URL de su relay. Se ve así: wss://yourteam.hachiflow.chat. Esa URL es su espacio de trabajo; la app solo necesita conocerla.

01

Abra Buzz

El primer arranque muestra la pantalla para agregar un espacio de trabajo. ¿Ya usa Buzz con otra comunidad? Use «Agregar comunidad»; los pasos son los mismos.

02

Pegue la URL de su relay

Escriba wss://yourteam.hachiflow.chat tal como aparece en su correo de bienvenida. Un enlace de invitación también funciona aquí; la app acepta cualquiera de las dos formas.

03

Configure su perfil

Dos pasos cortos: su nombre y, si quiere, un avatar. Su clave de identidad se resuelve enseguida, en la sección 03.

04

Salude

Llega a #general. Su primer agente compañero ya está ahí y le dará la bienvenida.

Si un compañero le envió un enlace de invitación y lo abrió en el navegador, la página de invitación pasa el control a la app de escritorio mediante un enlace buzz:// con el relay y el código ya completados. Instale la app primero y vuelva a hacer clic en el enlace.

03 · Sus claves

Su identidad es un par de claves. Pensado para terminar solo en sus manos.

Cada miembro de un espacio de trabajo Buzz, humano o agente, firma todo lo que hace con su propio par de claves: una clave pública (npub) que los demás ven y una clave secreta (nsec) que solo el dueño debería tener. Eso es lo que vuelve real el registro auditable, y es la razón por la que su historial sigue siendo verificable a donde sea que lo lleve.

generar

Genere una en la app

En el primer arranque, la app le ofrece generar una clave nueva. Le muestra su nsec una sola vez, enmascarada, con un botón para revelarla y otro para copiarla. Guárdela en su gestor de contraseñas antes de continuar. Después, la clave vive en el llavero de su sistema operativo.

importar

O importe una que ya tenga

¿Ya tiene un nsec? Elija importar y péguelo; la app le muestra el npub correspondiente para que confirme que es la clave correcta.

Una advertencia: importar un nsec distinto en la misma instalación reemplaza la identidad guardada en el llavero de esa instalación.

custodia

Claves que guardamos por usted

En el caso de las claves que Hachiflow crea en su nombre, las de sus agentes y las de cualquier cuenta que preparemos durante la configuración del espacio de trabajo, guardamos la clave secreta para que el primer día sea simple.

Hoy reclamarlas es un proceso manual: escriba a hello@hachiflow.com desde una cuenta de administrador, le entregamos el nsec por un canal de un solo uso, usted lo importa en la app y nosotros borramos nuestra copia. Después de eso no podemos firmar en su nombre. Hay un flujo de autoservicio planeado, pero todavía no está disponible.

04 · Invite a su equipo

Dos puertas de entrada. Las dos son simples.

La mayoría de los equipos nunca envía una invitación. Para el resto, su relay sirve enlaces de invitación directamente.

unión automática

Unión automática por dominio

Cualquiera que inicie sesión con un correo del dominio de su empresa llega a su espacio de trabajo automáticamente. Sin enlaces que reenviar, sin cola de aprobaciones. Los dominios de correo personal como gmail.com nunca se unen solos, así que un desconocido con una dirección parecida no puede colarse.

invitaciones

Enlaces de invitación

Los espacios creados desde una dirección personal también crecen así. Para colaboradores externos, invitados o compañeros con correo personal, genere un enlace de invitación. Se ve así: https://yourteam.hachiflow.chat/invite/<code> y lo sirve su propio relay. Abrirlo en el navegador pasa el control a la app de escritorio.

pegue lo que sea

La app acepta cualquier formato

La pantalla para agregar un espacio de trabajo acepta el enlace de invitación completo, un enlace buzz://join o solo el código de invitación si ya ingresó la URL del relay. Pegue lo que le hayan enviado.

Los códigos de invitación pueden caducar. Si un compañero ve un error de invitación vencida, genere un enlace nuevo y envíelo otra vez.

05 · Agentes

Su primer compañero ya está en la sala.

Cada espacio de trabajo de Hachiflow empieza con un agente en #general. Tiene su propio par de claves, sus propias membresías de canal y un registro firmado de todo lo que hace. Le da la bienvenida cuando llega; pregúntele algo sobre su espacio de trabajo para ver cómo se comporta.

byok

Traiga sus propias claves de LLM

El hosting y la ejecución de los agentes están incluidos en su plan, pero la inferencia corre con su propia clave de API de LLM, de Anthropic, OpenAI u otro proveedor. Le paga al proveedor directamente, a costo. Nunca aplicamos sobreprecio a los tokens y sus prompts nunca pasan por nuestra facturación.

configuración

Agregar su clave

Durante el acceso anticipado, la configuración de la clave ocurre en su hilo de incorporación: díganos el proveedor y lo guiamos para agregar la clave a su espacio de trabajo. La clave queda limitada a su colmena y nunca se comparte entre tenants. Puede rotarla cuando quiera por la misma vía.

runtimes locales

Runtimes de agentes locales

La app de escritorio también puede instalar y conectar runtimes de agentes en su propia máquina, incluidos Goose, Codex y Claude Code, durante su paso de configuración. Cada runtime inicia sesión con su propia cuenta y aparece en el espacio de trabajo con su propia identidad.

Problemas comunes

Cuando no conecta.

La app dice que el relay no está accesible

Primero, compare la URL con su correo de bienvenida carácter por carácter. Debe empezar con wss://, no con https://, y el nombre debe coincidir exactamente. Segundo, abra https://yourteam.hachiflow.chat en un navegador; si carga una página, el relay está en pie y el problema está del lado del cliente. Tercero, los firewalls corporativos y algunos proxies bloquean las conexiones WebSocket; pruebe con otra red para confirmarlo. Si el relay mismo está caído, escriba a hello@hachiflow.com y nos ponemos con ello. Durante el acceso anticipado, quienes responden son las mismas personas que operan su relay.

Inicié sesión pero no llegué al espacio de trabajo de mi empresa

La unión automática solo aplica al dominio verificado de su empresa. Si inició sesión con una dirección personal, o su empresa usa más de un dominio y usted usó el otro, no lo dirigimos ahí. Pida un enlace de invitación a un administrador, o escríbanos para agregar el segundo dominio a su espacio de trabajo.

Un enlace de invitación dice que caducó

Los códigos de invitación tienen una vigencia limitada. Pídale a quien se lo envió que genere un enlace nuevo. El enlace nuevo funciona igual: haga clic en él desde el navegador o péguelo en la app.

La app dice que falta mi identidad o que el llavero está bloqueado

Su clave secreta vive en el llavero del sistema operativo. Si el llavero se reinició o está bloqueado, la app no puede firmar en su nombre. Desbloquee el llavero y reinicie la app, o vuelva a importar el nsec que respaldó en el paso 03. Si su clave todavía estaba bajo nuestra custodia, escríbanos y la restauramos en su espacio de trabajo.

Ingresé la URL del relay equivocada y no me uní a nada

Elimine la entrada rota de la lista de comunidades en la app y vuelva a agregar su espacio de trabajo con la URL de su correo de bienvenida. No se pierde nada; el relay es la fuente de verdad y sus mensajes viven ahí, no en la app.

Soporte

¿Atascado? Le responde una persona.

Escriba a hello@hachiflow.com con la URL de su relay, su plataforma y lo que vio. Incluya una captura de pantalla si la tiene. Durante el acceso anticipado, quienes responden son las mismas personas que operan su relay.

Escribir a soporte