bruno/readme.md

125 lines
4.8 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/unit-tests.yml/badge.svg?branch=main)](https://github.com/usebruno/bruno/workflows/unit-tests.yml)
[![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)
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
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
### 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, Snap 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
# On Linux via Snap
snap install bruno
# 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 />
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-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 ❤️
Woof! If you like project, hit that ⭐ button !!
### 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-21 15:11:28 +02:00
### Contribute 👩‍💻🧑‍💻
2023-10-02 10:17:14 +02:00
2023-10-18 21:35:43 +02:00
I am happy that you are looking to improve bruno. Please check out the [contributing guide](contributing.md)
2022-10-21 15:11:28 +02:00
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.
2022-10-23 19:10:26 +02:00
### 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
### 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/)
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)