bruno/readme.md

155 lines
6.0 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)
2024-03-10 18:35:42 +01:00
[![CI](https://github.com/usebruno/bruno/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/usebruno/bruno/workflows/unit-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)
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
### Golden Edition ✨
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-02-29 17:14:06 +01:00
You can Pre-Orders the [Golden Edition](https://www.usebruno.com/pricing) at ~~$19~~ **$9** ! <br/>
### 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 [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
```
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 />
2024-03-07 16:52:27 +01:00
### Sponsors
#### Gold Sponsors
<img src="assets/images/sponsors/samagata.png" width="150"/>
#### Silver Sponsors
<img src="assets/images/sponsors/commit-company.png" width="70"/>
2023-10-05 12:14:34 +02:00
### Important Links 📌
- [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)
2023-11-24 11:23:43 +01:00
- [Github Sponsors](https://github.com/sponsors/helloanoop).
2023-01-24 17:14:33 +01:00
2023-10-05 16:00:38 +02:00
### Showcase 🎥
- [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 ❤️
2023-11-24 11:23:43 +01:00
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)
2023-10-22 22:26:05 +02:00
### Publishing to New Package Managers
Please see [here](publishing.md) for more information.
2022-10-16 10:21:10 +02:00
### 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/)
2024-01-07 11:09:59 +01:00
### Contribute 👩‍💻🧑‍💻
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
<div align="center">
<a href="https://github.com/usebruno/bruno/graphs/contributors">
<img src="https://contrib.rocks/image?repo=usebruno/bruno" />
</a>
</div>
2022-10-16 10:21:10 +02:00
### License 📄
2023-10-02 10:17:14 +02:00
2022-10-21 15:11:28 +02:00
[MIT](license.md)