Introduction
Postguy is a native desktop API client for HTTP, gRPC and WebSocket. It works like Postman, works completely offline, and supports Bruno collections. It is written in Rust with egui.
You can:
- Organise requests into collections, with environments and variables.
- Send requests and read responses.
- Write scripts and tests.
- Run collections.
- Import and export your data.
No account is needed. Nothing is synced or reported anywhere.
What it supports today
| Area | State |
|---|---|
| HTTP requests | Full: all common methods, bodies, auth types, per-request settings, cookies, redirects, proxy, TLS |
| Collections, folders, environments, globals | Full, stored as JSON files in a workspace folder |
| Scripts and tests | HTTP requests only, in a sandboxed QuickJS engine (pm, pg, and Bruno-style bru, req, res, test, expect) |
| Collection runner | HTTP requests only; gRPC and WebSocket requests are skipped |
| Import | Postman Collection v2.0/v2.1 (plus environments and globals), OpenAPI 3 and Swagger 2 (JSON or YAML), HAR 1.2, cURL, Bruno folders, .proto files, zip documents |
| Export | Collections, environments, globals, runs and the whole workspace |
| Code snippets | 8 languages for HTTP requests |
| gRPC | Basic client |
| WebSocket | Basic client |
| Headless use | postguy-cli with the same engine as the UI |
Bruno support
Postguy imports a Bruno collection folder:
- The
.brurequest files,bruno.json,environments/*.bruand a.envfile become a collection, environments and an import report. - Other files in the folder are copied into the collection's Assets.
The script engine also has the Bruno-style globals bru, req, res, test and expect. See Import and export and Scripting API.
Postguy does not export to the Bruno format.
Offline and privacy promises
- No telemetry, no crash upload, no update check and no cloud sync.
- The app makes no network request you did not start. Network use is limited to actions like sending a request, running a collection, fetching an OAuth 2.0 token and gRPC reflection.
- Everything lives in a workspace folder on your disk. See Workspace.
- Secret variable values are stored apart from the documents, so you can share a collection without them. They are not encrypted at rest.
Details are on Privacy and security.
Platforms
Postguy runs natively on macOS (11.0 or newer), Windows, Linux and FreeBSD. There is no web or WebAssembly build.
| Platform | How you get it |
|---|---|
| macOS (Apple Silicon and Intel) | Universal .dmg or .zip from the releases page |
| Windows (x64, x86, arm64) | .msi installer or portable .zip |
| Linux (x86_64, aarch64) | AppImage, .deb, .rpm, Flatpak bundle or tarball |
| FreeBSD | Build from source; no prebuilt package is published |
See Installation and Build from source.
Licence
Postguy is licensed under MIT OR Apache-2.0. Bundled third-party material, such as the Poppins font and Lucide icons, is listed in ATTRIBUTION.md and NOTICE.