Introduction to Heapi

Modern desktop HTTP/API client, open source and free, designed for developers who need to efficiently test, debug and manage APIs.

What is Heapi

Heapi is a desktop HTTP/API client inspired by tools like Postman and Insomnia, but focused on native performance, terminal integration and full support for local and collaborative workflows. Built with Go and Wails to be lightweight and efficient.

  • Execution of HTTP/REST, GraphQL and WebSocket requests
  • Collections and environments organized in Git-friendly YAML
  • Integrated terminal for test scripts and automation
  • Smart history with search and filters
  • Import/export from Postman and Insomnia
  • Responsive UI with unlimited tabs and dark mode
  • Local persistence without requiring account or cloud

Technical Architecture

  • Backend: Pure Go for maximum performance, concurrency with Goroutines and native OS integration.
  • Frontend: React + TypeScript + Tailwind CSS for a smooth experience.
  • Desktop: Wails (not Electron) for lightweight native binaries.
  • Database: SQLite for history and local settings.

License: Open Source + Open Core

Free Core (MIT)

Heapi Core is 100% open source under the MIT license. You can use, modify, distribute and even sell products based on it, as long as you keep the copyright notice.

  • All basic functionalities (requests, collections, terminal, local persistence).

Open Core (Commercial Optional)

For teams and companies, we offer advanced features under commercial license to ensure project sustainability.

  • Cloud synchronization with E2EE encryption
  • Secret management (HashiCorp Vault, AWS Secrets)
  • Single Sign-On (SSO/SAML/OIDC)
  • Access control, auditing and CI/CD reports
  • Headless CLI for automated pipelines

This model ensures the core remains free and auditable, while monetizing added value for organizations.

Installation

Prerequisites

  • Go 1.21+
  • Node.js 18+
  • Wails CLI (go install github.com/wailsapp/wails/v2/cmd/wails@latest)

Local Build

# Clone the repository
git clone https://github.com/marcelomatz/Heapi.git
cd Heapi

# Install backend dependencies
go mod tidy

# Install frontend dependencies
cd frontend
npm install
cd ..

# Build the app
wails build

# Run
./build/bin/heapi

Usage

  1. First run: Open the app and create a new collection
  2. Add requests: Configure headers, body, auth and execute
  3. Manage environments: Define variables like {{base_url}} for reuse
  4. Use the terminal: Run commands like curl or custom scripts
  5. Open a Pull Request

Contribution

Contributions are welcome! Heapi is a community project.

  1. Fork the repo
  2. Create a branch (git checkout -b feature/new-feature)
  3. Commit your changes (git commit -m 'Add new feature')
  4. Push (git push origin feature/new-feature)
  5. Open a Pull Request

Roadmap

  • v0.2: Advanced GraphQL support
  • v0.3: API manager integration (Swagger/OpenAPI)
  • v1.0: Complete Open Core features