Bruno software icon

Bruno 4.0.0

Bruno is an open-source desktop API client that saves requests as plain text files in a folder, so collections can be versioned and shared through Git. It covers request building, scripting, tests, collection runs, a CLI, API docs and mock servers.

Updated July 23, 2026
116.75 MB
0.0

Use the arrow keys to choose a rating, then press Enter or Space to submit it.

Not rated yet 0 user ratings

App Specs

DeveloperBruno
LicenseFreeware
CategorySystem Tools
Available platformsWindows, macOS, Linux
Downloads289

Overview

Bruno is an open-source API client for building, sending and testing requests to web APIs. It runs as a desktop application on Windows, macOS and Linux. A command-line tool and a VS Code extension work on the same collections. The open-source edition is free and needs no account; Pro and Ultimate are paid editions that add team, Git and enterprise features.

Collections stored as plain files

Bruno does not keep requests in a cloud workspace. Each collection is a folder on disk. Every request, folder, environment and collection setting is a readable text file inside it, written in the OpenCollection YAML format. Collections in Bruno’s older .bru format also open. Because the files sit next to project code, a change to an endpoint can be diffed, reviewed and merged like any other change.

Teams can keep collections in the same repository as the application they test or in a dedicated repository. Teams share them through their usual Git host, such as GitHub or GitLab, rather than through a Bruno server.

Building and sending requests

Bruno handles REST, GraphQL, gRPC, WebSocket and SOAP requests. Each request can use Basic, Bearer token, OAuth 2.0, AWS Signature and other authentication methods.

After a request runs, the response panel shows the status code and response headers. It shows the body in a formatted editor or a rendered preview, along with the request headers Bruno actually sent. A Timeline tab lists every call made during the run, including calls sent by scripts. A response can be saved as an example under its request.

The code generator turns a saved request into a snippet in more than 35 languages, such as Python, JavaScript or cURL. Pasting a cURL command does the reverse and creates a filled-in request.

Variables, environments and secrets

Values such as base URLs and tokens are stored as variables and inserted with double-brace syntax. Bruno resolves them across several scopes, from narrowest to broadest: runtime, request, folder, environment, collection and global. A narrower value wins. Environments can inherit from a parent environment.

Marking an environment variable as secret keeps its value out of the collection files. Bruno writes only the name and stores the value on the local machine with OS-level encryption, or AES-256 where that is unavailable. Values can also come from a .env file. Integration with external secret managers such as HashiCorp Vault, Azure Key Vault and AWS is part of the Ultimate edition.

Scripts and tests

Bruno can run JavaScript before sending a request and after its response arrives. A pre-request script can generate data, change the request or set variables. A post-response script can read the response and store values, such as a login token, for the next request. This is how requests are chained. External npm packages and file system access require Developer Mode, while the default Safe Mode runs scripts in a restricted sandbox.

Tests use the Chai expect syntax inside named test blocks, with helpers for the status, headers, body and response time. Bruno adds assertions for checking JSON paths and validating a response body against a JSON Schema.

Running whole collections

The built-in collection runner executes every HTTP request in a collection or folder in one pass, with an optional delay between requests. Runs are unlimited in all editions; the runner skips gRPC and WebSocket requests. Feeding the runner a CSV file to repeat requests with different data is a paid feature.

The Bruno CLI runs the same collections from a terminal or a CI/CD pipeline. It can run a single request, a folder or a full collection and select an environment. It can also filter requests by tag and write results as JSON, JUnit or HTML reports.

Importing and syncing API specs

Bruno imports Postman collections, Insomnia collections, OpenAPI 2.0 and 3.x specs, WSDL files, other Bruno collections and Git repositories that contain a collection.

OpenAPI Sync connects a collection to a remote spec and checks it for changes periodically. When the spec changes, Bruno lists each difference for you to accept or skip. Bruno keeps scripts, tests and assertions in the collection during a sync. The free edition allows a limited number of syncs per month.

Documentation and mock servers

You can write Markdown notes for a workspace, collection, folder or request. Bruno can publish a collection as a standalone HTML site with an environment switcher, search, a try-it panel and generated code samples. The site is readable without Bruno installed.

Mock servers run a local HTTP server that answers from a collection’s saved examples or from an OpenAPI spec. The server matches requests by method and path, with optional rules on headers, query or body. Bruno saves mock definitions with the collection, so anyone who clones the repository gets the same mocks.

Git inside the app

The Git panel in Bruno works on collections directly. In the free edition it can clone, initialize a repository, show diffs, check for updates and pull. This edition supports up to two workspaces and public Git providers. Pro adds push, branching, remote connections, stash, merge conflict resolution, private Git providers and unlimited workspaces. Ultimate builds on Pro with secret manager integration, report generation, SSO and SCIM provisioning.

Key Features

  • File-based API collections
  • HTTP and GraphQL requests
  • Environment variables and authentication
  • Scripts and response assertions
  • Command-line collection runner

Similar Apps