forked from extern/bruno
130 lines
5.3 KiB
Markdown
130 lines
5.3 KiB
Markdown
<br />
|
||
<img src="assets/images/logo-transparent.png" width="80"/>
|
||
|
||
### Bruno - Opensource IDE for exploring and testing APIs.
|
||
|
||
[](https://badge.fury.io/gh/usebruno%bruno)
|
||
[](https://github.com/usebruno/bruno/workflows/unit-tests.yml)
|
||
[](https://github.com/usebruno/bruno/pulse)
|
||
[](https://twitter.com/use_bruno)
|
||
[](https://www.usebruno.com)
|
||
[](https://www.usebruno.com/downloads)
|
||
|
||
**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)
|
||
|
||
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](https://github.com/usebruno/bruno/discussions/269)
|
||
|
||
📢 Watch our recent talk at India FOSS 3.0 Conference [here](https://www.youtube.com/watch?v=7bSMFpbcPiY)
|
||
|
||
 <br /><br />
|
||
|
||
### Installation
|
||
|
||
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 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 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
|
||
```
|
||
|
||
### Run across multiple platforms 🖥️
|
||
|
||
 <br /><br />
|
||
|
||
### Collaborate via Git 👩💻🧑💻
|
||
|
||
Or any version control system of your choice
|
||
|
||
 <br /><br />
|
||
|
||
### 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)
|
||
- [Website](https://www.usebruno.com)
|
||
- [Pricing](https://www.usebruno.com/pricing)
|
||
- [Download](https://www.usebruno.com/downloads)
|
||
- [Github Sponsors](https://github.com/sponsors/helloanoop).
|
||
|
||
### 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 ❤️
|
||
|
||
If you like Bruno and want to support our opensource work, consider sponsoring us via [Github Sponsors](https://github.com/sponsors/helloanoop).
|
||
|
||
### Share Testimonials 📣
|
||
|
||
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
|
||
|
||
Please see [here](publishing.md) for more information.
|
||
|
||
### 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>
|
||
|
||
### Stay in touch 🌐
|
||
|
||
[𝕏 (Twitter)](https://twitter.com/use_bruno) <br />
|
||
[Website](https://www.usebruno.com) <br />
|
||
[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/)
|
||
|
||
### License 📄
|
||
|
||
[MIT](license.md)
|