Qué es Bruno
Probar una API es mandarle un pedido (por ejemplo, un GET a una dirección) y mirar qué te responde, sin tener que armar todavía la pantalla que la va a usar. Bruno es un programa de escritorio para hacer eso: escribís la dirección, enviás el pedido y ves la respuesta.
Lo distinto es dónde guarda las cosas. Tus pedidos se agrupan en colecciones, y cada colección es una carpeta de tu compu con archivos de texto plano (en un lenguaje propio llamado Bru). No hay nube ni cuenta: el proyecto lo dice así en su README, «Bruno is offline-only. There are no plans to add cloud-sync to Bruno, ever.» Como son archivos comunes, los subís a git junto con tu código y los compartís con tu equipo.
| Dato | Valor |
|---|---|
| Precio | Gratis |
| Licencia | Open source, MIT |
| Versión revisada | v4.2.1 (30 de septiembre de 2026) |
| Dónde guarda tus pedidos | En una carpeta de tu sistema, como texto plano (Bru) |
| Nube | No tiene, y no hay planes de agregarla |
| Cómo se comparte | Con git |
| Sitio | usebruno.com |
| Código | github.com/usebruno/bruno |
Lo que necesitás
- Una API para probar. Lo más seguro es una copia corriendo en tu compu, no la de producción.
- Git, si querés guardar los pedidos con tu proyecto y compartirlos.
1 · Instalarlo
| Sistema | Comando |
|---|---|
| Windows | winget install Bruno.Bruno (también choco install bruno, o scoop bucket add extras y después scoop install bruno) |
| macOS | brew install bruno |
| Arch, CachyOS | paru -S bruno-bin (paquete de AUR) |
| Linux con snap | snap install bruno |
| Linux con flatpak | flatpak install com.usebruno.Bruno |
| Debian, Ubuntu | Con el repositorio apt que figura en la documentación de Bruno |
2 · Tu primer pedido
- Abrí Bruno. No te pide iniciar sesión ni crear una cuenta.
- Creá una colección. Una colección es el grupo de pedidos de un proyecto. Al crearla elegís en qué carpeta de tu compu se guarda. Si la querés compartir, elegí una carpeta dentro del repositorio de tu proyecto.
- Creá un pedido nuevo. En la colección, apretá el botón
···y elegí New Request. Completá el tipo, el nombre, el método (por ejemplo, GET) y la URL de tu API, y confirmá con Create. También podés crear uno con el + de las pestañas. - Envialo. Mandá el pedido y mirá el panel de la derecha: ahí aparece la respuesta de tu API.
- Mirá la carpeta. A la izquierda, Bruno te muestra la colección con sus carpetas y pedidos. Si abrís esa misma carpeta fuera del programa, vas a ver que cada pedido es un archivo
.bruque podés leer como texto.
3 · Compartirlo con tu equipo
- Revisá qué hay para subir. En la terminal, dentro de tu repositorio, corré
git status. Los archivos de la colección aparecen como cualquier otro archivo nuevo. - Subilos con tu código. Sumalos a un commit y hacé el push como hacés siempre con el resto del proyecto.
- Que tu equipo abra la misma carpeta. Quien baja el repositorio tiene los mismos pedidos, sin que nadie cree una cuenta.
4 · Correr un pedido desde la terminal
Bruno tiene una herramienta de línea de comandos, Bruno CLI. Con ella corrés un pedido guardado sin abrir el programa:
bru run request.bru
Cambiá request.bru por el nombre del archivo de tu pedido.
Si algo falla
- Los botones no se llaman igual que acá. Los pasos para crear un pedido salen de la documentación oficial revisada para la v4.2.1. Si tu versión es otra, pueden cambiar: buscá la opción equivalente en el menú
···de la colección o usá el + de las pestañas. - En Arch o CachyOS te instala una versión anterior. El paquete
bruno-binde AUR estaba en la 4.2.0-1 el 1 de octubre de 2026, una atrás de la v4.2.1. Se actualiza cuando lo hace quien mantiene el paquete. - No tenés
paru. Usá una de las otras opciones de Linux:snap install brunooflatpak install com.usebruno.Bruno. - El pedido no devuelve nada. Revisá que tu API esté corriendo y que la URL del pedido sea la misma dirección y puerto donde la levantaste.
- No encontrás tus pedidos en otra compu. Bruno no sincroniza nada: los pedidos viven en la carpeta que elegiste al crear la colección. Para tenerlos en otra máquina, subí esa carpeta a git y bajala ahí.
bru: command not found. El comandobrues de Bruno CLI, que es una herramienta aparte del programa de escritorio. Los pasos para instalarla están en el README de github.com/usebruno/bruno.