README

Bruno - Opensource IDE for exploring and testing APIs.








English
| Українська
| Русский
| Türkçe
| Deutsch
| Français
| Português (BR)
| 한국어
| বাংলা
| Español
| Italiano
| Română
| Polski
| 简体中文
| 正體中文
| العربية
| 日本語
| ქართული
| Nederlands
| فارسی
| हिन्दी

Bruno is a new and innovative API client, aimed at revolutionizing the status quo represented by Postman and similar tools out there.

Bruno stores your collections directly in a folder on your filesystem. We use a plain text markup language, Bru, to save information about API requests.

You can use Git or any version control of your choice to collaborate over your API collections.

Bruno is offline-only. There are no plans to add cloud-sync to Bruno, ever. We value your data privacy and believe it should stay on your device. Read our long-term vision here

Download Bruno

📢 Watch our recent talk at India FOSS 3.0 Conference here

!bruno
!bruno 

 Commercial Versions ✨

Majority of our features are free and open source.
We strive to strike a harmonious balance between open-source principles and sustainability

You can explore our paid versions to see if there are additional features that you or your team may find useful! 

 Table of Contents

- Installation
- Bruno CLI
- Run with Docker
- Features
  - Run across multiple platforms 🖥️
  - Collaborate via Git 👩‍💻🧑‍💻
- Important Links 📌
- Showcase 🎥
- Share Testimonials 📣
- Publishing to New Package Managers
- Stay in touch 🌐
- Trademark
- Contribute 👩‍💻🧑‍💻
- Authors
- License 📄

 Installation

Bruno is available as binary download on our website for Mac, Windows and Linux.

You can also install Bruno via package managers like Homebrew, Chocolatey, Scoop, Snap, Flatpak and Apt.

sh
 On Mac via Homebrew
brew install bruno

 On Windows via Chocolatey
choco install bruno

 On Windows via Scoop
scoop bucket add extras
scoop install bruno

 On Windows via winget
winget install Bruno.Bruno

 On Linux via Snap
snap install bruno

 On Linux via Flatpak
flatpak install com.usebruno.Bruno

 On Arch Linux via AUR
yay -S bruno

 On Linux via Apt
sudo mkdir -p /etc/apt/keyrings
sudo apt update && sudo apt install gpg curl
curl -fsSL "https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x9FA6017ECABE0266" \
  | gpg --dearmor \
  | sudo tee /etc/apt/keyrings/bruno.gpg  /dev/null
sudo chmod 644 /etc/apt/keyrings/bruno.gpg
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/bruno.gpg] http://debian.usebruno.com/ bruno stable" \
  | sudo tee /etc/apt/sources.list.d/bruno.list
sudo apt update && sudo apt install bruno


 Bruno CLI

The Bruno CLI lets you run your API collections from the command line, which is ideal for automated testing and CI/CD pipelines. Install it from npm using the package manager of your choice:

sh
npm install -g @usebruno/cli


Navigate to the directory containing your collection and run it:

sh
 Run every request in the collection
bru run

 Run a single request
bru run request.bru

 Run a folder against a specific environment
bru r

Top issues

Discussions

Latest release

Changelog

 Features
- feat(converter): enhance OAuth2 token handling in processAuth function by @sanish-bruno in 9454
- feat(runner): store runner payloads in the file store by @chirag-bruno in 9408
- feat(sqlite-file): add a file store to the SQLite SDK by @chirag-bruno in 9405
- feat(openapi): revamp Create OpenAPI spec Modal by @adwait-bruno in 9302
- feat: show keyboard shortcut hints in menus by @lohit-bruno in 9426
- feat: add unresolved variables info card by @prateek-bruno in 9401
- feat(benchmark): utils to measure over checkpoints, spans, and also drain them by @sid-bruno i