bruno/readme.md

201 lines
7.1 KiB
Markdown
Raw Normal View History

<br />
<img src="assets/images/logo-transparent.png" width="80"/>
2022-10-21 15:11:28 +02:00
2023-10-02 10:17:14 +02:00
### Bruno - Opensource IDE for exploring and testing APIs.
2023-01-29 19:58:42 +01:00
[![GitHub version](https://badge.fury.io/gh/usebruno%2Fbruno.svg)](https://badge.fury.io/gh/usebruno%bruno)
[![CI](https://github.com/usebruno/bruno/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/usebruno/bruno/actions/workflows/tests.yml)
2023-01-29 19:58:42 +01:00
[![Commit Activity](https://img.shields.io/github/commit-activity/m/usebruno/bruno)](https://github.com/usebruno/bruno/pulse)
2023-10-05 21:47:14 +02:00
[![X](https://img.shields.io/twitter/follow/use_bruno?style=social&logo=x)](https://twitter.com/use_bruno)
2023-01-29 19:58:42 +01:00
[![Website](https://img.shields.io/badge/Website-Visit-blue)](https://www.usebruno.com)
2023-01-29 20:13:30 +01:00
[![Download](https://img.shields.io/badge/Download-Latest-brightgreen)](https://www.usebruno.com/downloads)
2023-01-29 19:58:42 +01:00
**English**
| [Українська](docs/readme/readme_ua.md)
| [Русский](docs/readme/readme_ru.md)
| [Türkçe](docs/readme/readme_tr.md)
| [Deutsch](docs/readme/readme_de.md)
| [Français](docs/readme/readme_fr.md)
| [Português (BR)](docs/readme/readme_pt_br.md)
| [한국어](docs/readme/readme_kr.md)
| [বাংলা](docs/readme/readme_bn.md)
| [Español](docs/readme/readme_es.md)
| [Italiano](docs/readme/readme_it.md)
| [Română](docs/readme/readme_ro.md)
| [Polski](docs/readme/readme_pl.md)
| [简体中文](docs/readme/readme_cn.md)
| [正體中文](docs/readme/readme_zhtw.md)
| [العربية](docs/readme/readme_ar.md)
| [日本語](docs/readme/readme_ja.md)
| [ქართული](docs/readme/readme_ka.md)
2024-09-15 21:51:23 +02:00
| [Nederlands](docs/readme/readme_nl.md)
2023-10-05 21:47:14 +02:00
2023-01-29 19:58:42 +01:00
Bruno is a new and innovative API client, aimed at revolutionizing the status quo represented by Postman and similar tools out there.
2023-01-29 20:09:39 +01:00
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.
2023-01-22 01:30:00 +01:00
2023-10-31 05:19:38 +01:00
You can use Git or any version control of your choice to collaborate over your API collections.
2023-01-29 19:58:42 +01:00
2023-10-02 10:28:09 +02:00
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](https://github.com/usebruno/bruno/discussions/269)
2023-01-29 19:58:42 +01:00
2024-02-29 17:14:06 +01:00
[Download Bruno](https://www.usebruno.com/downloads)
2023-11-01 13:55:25 +01:00
📢 Watch our recent talk at India FOSS 3.0 Conference [here](https://www.youtube.com/watch?v=7bSMFpbcPiY)
2023-01-29 20:09:39 +01:00
![bruno](assets/images/landing-2.png) <br /><br />
2022-10-23 19:10:26 +02:00
2024-11-22 13:07:07 +01:00
## Commercial Versions ✨
Majority of our features are free and open source.
We strive to strike a harmonious balance between [open-source principles and sustainability](https://github.com/usebruno/bruno/discussions/269)
2024-11-22 13:07:07 +01:00
You can explore our [paid versions](https://www.usebruno.com/pricing) to see if there are additional features that you or your team may find useful! <br/>
## Table of Contents
- [Installation](#installation)
- [Features](#features)
- [Run across multiple platforms 🖥️](#run-across-multiple-platforms-%EF%B8%8F)
- [Collaborate via Git 👩‍💻🧑‍💻](#collaborate-via-git-)
- [Sponsors](#sponsors)
- [Gold Sponsors](#gold-sponsors)
- [Silver Sponsors](#silver-sponsors)
- [Bronze Sponsors](#bronze-sponsors)
- [Important Links 📌](#important-links-)
- [Showcase 🎥](#showcase-)
- [Support ❤️](#support-%EF%B8%8F)
- [Share Testimonials 📣](#share-testimonials-)
- [Publishing to New Package Managers](#publishing-to-new-package-managers)
- [Stay in touch 🌐](#stay-in-touch-)
- [Trademark](#trademark)
- [Contribute 👩‍💻🧑‍💻](#contribute-)
- [Authors](#authors)
- [License 📄](#license-)
## Installation
2023-11-01 13:53:27 +01:00
Bruno is available as binary download [on our website](https://www.usebruno.com/downloads) for Mac, Windows and Linux.
You can also install Bruno via package managers like Homebrew, Chocolatey, Scoop, Snap, Flatpak and Apt.
```sh
2023-11-01 13:53:27 +01:00
# On Mac via Homebrew
brew install bruno
2023-11-01 13:53:27 +01:00
# On Windows via Chocolatey
choco install bruno
2023-11-28 18:22:31 +01:00
# On Windows via Scoop
scoop bucket add extras
scoop install bruno
# On Windows via winget
winget install Bruno.Bruno
2023-11-01 13:53:27 +01:00
# On Linux via Snap
snap install bruno
# On Linux via Flatpak
flatpak install com.usebruno.Bruno
2023-11-01 13:53:27 +01:00
# On Linux via Apt
sudo mkdir -p /etc/apt/keyrings
sudo gpg --no-default-keyring --keyring /etc/apt/keyrings/bruno.gpg --keyserver keyserver.ubuntu.com --recv-keys 9FA6017ECABE0266
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
2023-11-01 13:53:27 +01:00
sudo apt update
sudo apt install bruno
```
## Features
2023-03-30 07:26:37 +02:00
### Run across multiple platforms 🖥️
2023-10-02 10:17:14 +02:00
2023-03-30 07:26:37 +02:00
![bruno](assets/images/run-anywhere.png) <br /><br />
### Collaborate via Git 👩‍💻🧑‍💻
2023-10-02 10:17:14 +02:00
2023-03-30 07:26:37 +02:00
Or any version control system of your choice
![bruno](assets/images/version-control.png) <br /><br />
## Sponsors
2024-03-07 16:52:27 +01:00
#### Gold Sponsors
<img src="assets/images/sponsors/samagata.png" width="150"/>
#### Silver Sponsors
<img src="assets/images/sponsors/commit-company.png" width="70"/>
2024-03-22 23:35:34 +01:00
#### Bronze Sponsors
2024-03-22 23:39:10 +01:00
<a href="https://zuplo.link/bruno">
2024-03-22 23:40:29 +01:00
<img src="assets/images/sponsors/zuplo.png" width="120"/>
2024-03-22 23:35:34 +01:00
</a>
## Important Links 📌
2023-10-05 12:14:34 +02:00
- [Our Long Term Vision](https://github.com/usebruno/bruno/discussions/269)
- [Roadmap](https://github.com/usebruno/bruno/discussions/384)
- [Documentation](https://docs.usebruno.com)
- [Stack Overflow](https://stackoverflow.com/questions/tagged/bruno)
2023-10-05 12:14:34 +02:00
- [Website](https://www.usebruno.com)
- [Pricing](https://www.usebruno.com/pricing)
2023-10-05 12:14:34 +02:00
- [Download](https://www.usebruno.com/downloads)
- [GitHub Sponsors](https://github.com/sponsors/helloanoop).
2023-01-24 17:14:33 +01:00
## Showcase 🎥
2023-10-05 16:00:38 +02:00
- [Testimonials](https://github.com/usebruno/bruno/discussions/343)
- [Knowledge Hub](https://github.com/usebruno/bruno/discussions/386)
- [Scriptmania](https://github.com/usebruno/bruno/discussions/385)
## Support ❤️
If you like Bruno and want to support our opensource work, consider sponsoring us via [GitHub Sponsors](https://github.com/sponsors/helloanoop).
## Share Testimonials 📣
2023-10-18 21:35:43 +02:00
If Bruno has helped you at work and your teams, please don't forget to share your [testimonials on our GitHub discussion](https://github.com/usebruno/bruno/discussions/343)
## Publishing to New Package Managers
2023-10-22 22:26:05 +02:00
Please see [here](publishing.md) for more information.
## Stay in touch 🌐
2023-10-02 10:17:14 +02:00
[𝕏 (Twitter)](https://twitter.com/use_bruno) <br />
[Website](https://www.usebruno.com) <br />
2023-10-18 21:35:43 +02:00
[Discord](https://discord.com/invite/KgcZUncpjq) <br />
[LinkedIn](https://www.linkedin.com/company/usebruno)
## Trademark
**Name**
`Bruno` is a trademark held by [Anoop M D](https://www.helloanoop.com/)
**Logo**
The logo is sourced from [OpenMoji](https://openmoji.org/library/emoji-1F436/). License: CC [BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/)
## Contribute 👩‍💻🧑‍💻
2024-01-07 11:09:59 +01:00
I am happy that you are looking to improve bruno. Please check out the [contributing guide](contributing.md)
Even if you are not able to make contributions via code, please don't hesitate to file bugs and feature requests that needs to be implemented to solve your use case.
## Authors
2024-01-07 11:09:59 +01:00
<div align="center">
<a href="https://github.com/usebruno/bruno/graphs/contributors">
<img src="https://contrib.rocks/image?repo=usebruno/bruno" />
</a>
</div>
## License 📄
2023-10-02 10:17:14 +02:00
2022-10-21 15:11:28 +02:00
[MIT](license.md)