Skip to content

krockxz/gostman

Repository files navigation

Gostman

Gostman Logo

Modern API Client for GraphQL, REST & WebSocket

Native, Privacy-First, and 10x Lighter than Postman.

License: MIT Go Version React


Gostman Landing Page

Overview

Gostman is a modern, cross-platform API client built with Wails (Go + React). It combines the performance of a native Go backend with the beautiful, reactive UI of modern web technologies. Designed for developers who value speed, privacy, and simplicity without compromising on power.

Features

  • 🚀 Multi-Protocol Support: Native support for REST, GraphQL, and WebSockets.
  • ⛓️ Request Chaining: Use response data as variables in subsequent requests for complex workflows.
  • 📜 Test Scripts: Automate assertions and tests with a built-in JavaScript/Chai-powered runtime.
  • Lightning Fast: Built with Go for instant startup and blazing-fast response times.
  • 🎨 Beautiful UI: Modern glassmorphic design with smooth animations and dark mode.
  • 🔄 Import/Export: Effortlessly migrate with support for Postman collections and OpenAPI specs.
  • 🔒 Local & Private: All data stays on your machine. No cloud sync, no tracking, no accounts.
  • 📂 Collections & Environments: Organize requests and manage Dev/Staging/Prod variables with ease.
  • ⌨️ Power User UX: Native keyboard shortcuts and intuitive workflow.

Installation

Download Pre-built Binaries

Visit the Releases page to download the latest version:

OS Format Download
macOS .zip Universal Binary (Intel + Apple Silicon)
Windows .exe 64-bit Installer

Build from Source

Prerequisites:

# 1. Install Wails
go install github.com/wailsapp/wails/v2/cmd/wails@latest

# 2. Clone the repository
git clone https://github.com/krockxz/gostman.git
cd gostman/gostman-gui

# 3. Build the application
wails build

Run the binary from build/bin/.

Why Gostman?

Feature Gostman Postman Insomnia
Launch Speed < 1s 10-20s 5-10s
Privacy 🔒 100% Local ☁️ Cloud Sync ☁️ Cloud Sync
Memory Usage ~100MB ~1GB+ ~500MB+
GraphQL/WS ✅ Native ✅ Native ✅ Native
Data Ownership You own it Vendor lock-in Vendor lock-in

Technical Details

Multi-Protocol Power

Gostman isn't just for REST. Test GraphQL APIs with full schema awareness and WebSockets for real-time app testing, all within the same interface.

Test Automation

Write tests in JavaScript using a familiar syntax. Assert response statuses, JSON body properties, and headers.

gostman.test("Status code is 200", () => {
    gostman.response.to.have.status(200);
});

Zero-Friction Migration

Don't get stuck. Import your existing Postman Collections (v2.1) and Environment files instantly. Export your Gostman collections anytime in standard formats.

Development

Live Development (Hot Reload)

Run the application in development mode. This starts both the Go backend and the Vite frontend server.

cd gostman-gui
wails dev

Web Version

Gostman also runs as a pure web application (with some limitations like CORS, handled via proxy in production).

cd gostman-gui/frontend
npm run dev:web

Project Structure

gostman/
├── gostman-gui/     # Main Application
│   ├── main.go      # Application entry point
│   ├── app.go       # Wails app context and backend methods
│   ├── wails.json   # Wails project configuration
│   ├── frontend/    # React frontend (Vite)
│   │   ├── src/
│   │   │   ├── App.jsx       # Desktop app component
│   │   │   ├── WebApp.jsx    # Web app component (with landing page)
│   │   │   ├── components/   # UI Components
│   │   │   └── lib/          # Utilities (API, Storage, etc.)
│   └── build/       # Build output
└── README.md        # Project Documentation

Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.

License

This project is licensed under the MIT License - see the LICENSE file for details.

About

Gostman is a modern, privacy-first HTTP client built to prove that developer tools can be powerful without being bloated. By combining the raw performance of Go with the reactive UI of React (via Wails), Gostman launches in milliseconds and stays under 50MB

Topics

Resources

Stars

Watchers

Forks

Contributors