Skip to content

lakernote/EasyPostman

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

2,016 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

EasyPostman Logo

EasyPostman

An open-source API debugging & performance testing desktop app
Inspired by Postman ยท Powered by Java ยท Built for developers

GitHub license GitHub release GitHub stars Java Platform

GitHub Gitee

็ฎ€ไฝ“ไธญๆ–‡ ยท English ยท ๐Ÿ“ฆ Download ยท ๐Ÿ“– Docs ยท ๐Ÿ’ฌ Discuss


๐Ÿ“– Table of Contents


๐Ÿ’ก About

EasyPostman provides developers with a local, privacy-first API debugging experience comparable to Postman, plus simplified JMeter-style performance testing. Built with Java Swing for cross-platform support, it works completely offline and includes built-in Git workspace support for team collaboration and version control.

๐ŸŽฏ Focus on Core ๐Ÿ”’ Privacy First ๐Ÿš€ Performance
Simple yet powerful, rich features without bloat 100% local storage, no cloud sync, your data stays private Native Java app, fast startup, smooth experience

โœจ Features

๐Ÿข Workspace & Collaboration

  • Local Workspace - Personal projects with local storage
  • Git Workspace - Version control and team collaboration
  • Multi-device Sync - Share API data via Git repositories
  • Project Isolation - Each workspace manages its own collections and environments

๐Ÿ”Œ API Testing

  • HTTP/HTTPS - Full REST API support (GET, POST, PUT, DELETE, etc.)
  • WebSocket & SSE - Real-time protocol support
  • Multiple Body Types - Form Data, JSON, XML, Binary
  • File Upload/Download - Drag & drop support
  • Environment Variables - Multi-environment management with dynamic variables

โšก Performance Testing

  • Thread Group Modes - Fixed, Ramp-up, Stair-step, Spike
  • Real-time Monitoring - TPS, response time, error rate
  • Visual Reports - Performance trend charts and result trees
  • Batch Requests - Simplified JMeter-style testing

๐Ÿ“ Advanced Features

  • Pre-request Scripts - JavaScript execution before requests with Redis/Kafka/Elasticsearch/InfluxDB access
  • Test Scripts - Assertions for HTTP responses and external data-store query/write results
  • Data Store Script APIs - Read, write, and validate Redis, Kafka, Elasticsearch, and InfluxDB directly in scripts
  • Request Chaining - Extract data and pass to next request
  • Network Event Log - Detailed request/response analysis
  • Import/Export - Postman v2.1, cURL, HAR (in progress)

๐ŸŽจ User Experience

  • Light & Dark Mode - Comfortable viewing in any lighting
  • Multi-language - English, ็ฎ€ไฝ“ไธญๆ–‡
  • Syntax Highlighting - JSON, XML, JavaScript
  • Cross-platform - Windows, macOS, Linux

๐Ÿ“– View All Features โ†’


๐Ÿ“ฆ Download

Latest Release

๐Ÿ”— GitHub Releases | Gitee Mirror (China)

Platform Downloads

Platform Package Notes
๐ŸŽ macOS (Apple Silicon) EasyPostman-{version}-macos-arm64.dmg M1/M2/M3/M4
๐Ÿ macOS (Intel) EasyPostman-{version}-macos-x86_64.dmg Intel-based Mac
๐ŸชŸ Windows (Installer) EasyPostman-{version}-windows-x64.exe Auto-update support
๐ŸชŸ Windows (Portable) EasyPostman-{version}-windows-x64-portable.zip No install needed
๐Ÿง Ubuntu / Debian easypostman_{version}_amd64.deb DEB package
โ˜• Cross-platform JAR easy-postman-{version}.jar Requires Java 17+

โš ๏ธ First Run Notice

  • Windows: SmartScreen warning โ†’ "More info" โ†’ "Run anyway"
  • macOS: "Cannot be opened" โ†’ Right-click โ†’ "Open" โ†’ "Open"

The app is 100% open-source. Warnings appear because we don't purchase code signing certificates.

๐ŸŒ Gitee Mirror only provides macOS (ARM) DMG and Windows packages. For other platforms, use GitHub Releases.


๐Ÿš€ Quick Start

Option 1: Download Pre-built Release

  1. Grab the package for your platform from Releases
  2. Install and run:
Platform Command / Action
macOS Open DMG โ†’ drag to Applications
Windows Installer Run .exe, follow wizard
Windows Portable Extract ZIP โ†’ run EasyPostman.exe
Linux DEB sudo dpkg -i easypostman_{version}_amd64.deb
JAR java -jar easy-postman-{version}.jar

Option 2: Build from Source

git clone https://github.com/lakernote/easy-postman.git
cd easy-postman
mvn clean package
java -jar target/easy-postman-*.jar

๐Ÿ“– Build Guide โ†’

First Steps

  1. Create a Workspace โ€” Local (personal) or Git (team)
  2. Create a Collection โ€” Organize your API requests
  3. Send Your First Request โ€” Enter URL, configure params, click Send
  4. Set Up Environments โ€” Switch between dev / test / prod easily

๐Ÿ–ผ๏ธ Screenshots

Home Workspaces
Home Workspaces
Collections & API Testing Performance Testing
Collections Performance

๐Ÿ“ธ View All Screenshots โ†’


๐Ÿค Contributing

We welcome all forms of contribution โ€” bug reports, feature requests, code, or docs!

Type How
๐Ÿ› Bug Report Open an issue
โœจ Feature Request Share your idea
๐Ÿ’ป Code Fork โ†’ branch โ†’ PR
๐Ÿ“ Docs Fix typos, add examples, translate

Every PR triggers automated checks: build, tests, code quality, and format validation.

๐Ÿ“– Contributing Guide โ†’


๐Ÿ“š Documentation

Doc Description
๐Ÿ“– Features Comprehensive feature documentation
๐Ÿ—๏ธ Architecture Technical stack and design
๐Ÿš€ Build Guide Build from source & generate installers
๐Ÿ–ผ๏ธ Screenshots All application screenshots
๐Ÿ“ Script API Reference Pre-request & test script API, including Redis/Kafka/ES/InfluxDB
๐Ÿ“ Script Snippets Built-in snippets, including data-store read/write/assert examples
๐Ÿ” Client Certificates mTLS configuration
๐Ÿง Linux Build Building on Linux
โ“ FAQ Frequently asked questions

โ“ FAQ

Q: Why local storage instead of cloud sync?

We value developer privacy. Local storage ensures your API data is never leaked to third parties. Use Git workspace for team collaboration while maintaining full control over your data.

Q: How to import Postman data?

In the Collections view, click Import and select a Postman v2.1 JSON file. Collections, requests, and environments are converted automatically.

Q: Why does Windows/macOS show security warnings?
  • Windows SmartScreen: No code signing cert (~$100โ€“400/year). โ†’ Click "More info" โ†’ "Run anyway". Warnings decrease as download count grows.
  • macOS Gatekeeper: No Apple Developer cert ($99/year). โ†’ Right-click โ†’ "Open", or run: sudo xattr -rd com.apple.quarantine /Applications/EasyPostman.app

This project is fully open-source and auditable on GitHub.

Q: Does it support team collaboration?

โœ… Yes โ€” use Git workspace to share collections & environments, track changes (commit/push/pull), and collaborate across devices without any cloud service.

Q: Are workspaces isolated?

Yes. Each workspace has its own collections, environments, and history. Switching workspaces provides complete data isolation.

Q: Which Git platforms are supported?

All standard Git platforms: GitHub, Gitee, GitLab, Bitbucket, and self-hosted Git servers (HTTPS or SSH).


๐Ÿ’– Support the Project

If EasyPostman helps you, consider:

  • โญ Star this repo โ€” it means a lot!
  • ๐Ÿด Fork & contribute โ€” help make it better
  • ๐Ÿ“ข Share with friends โ€” spread the word
  • ๐Ÿ’ฌ WeChat group โ€” add lakernote for direct communication
  • ๐Ÿ’ฌ GitHub Discussions โ€” ask questions & share ideas

โญ Star History

Star History Chart


๐Ÿ™ Acknowledgements

Thanks to these awesome open-source projects:

Project Role
FlatLaf Modern Swing theme
RSyntaxTextArea Syntax highlighting editor
OkHttp HTTP client
Termora Terminal emulator inspiration

Make API debugging easier. Make performance testing more intuitive.

GitHub Gitee

Made with โค๏ธ by laker

About

An open-source API debugging and stress testing tool inspired by Postman and a simplified JMeter, optimized for developers with a clean UI and powerful features.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages