An open-source API debugging & performance testing desktop app
Inspired by Postman ยท Powered by Java ยท Built for developers
็ฎไฝไธญๆ ยท English ยท ๐ฆ Download ยท ๐ Docs ยท ๐ฌ Discuss
- ๐ก About
- โจ Features
- ๐ฆ Download
- ๐ Quick Start
- ๐ผ๏ธ Screenshots
- ๐ค Contributing
- ๐ Documentation
- โ FAQ
- ๐ Support
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 |
- 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
- 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
- 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
- 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)
- Light & Dark Mode - Comfortable viewing in any lighting
- Multi-language - English, ็ฎไฝไธญๆ
- Syntax Highlighting - JSON, XML, JavaScript
- Cross-platform - Windows, macOS, Linux
๐ GitHub Releases | Gitee Mirror (China)
| 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.
- Grab the package for your platform from Releases
- 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 |
git clone https://github.com/lakernote/easy-postman.git
cd easy-postman
mvn clean package
java -jar target/easy-postman-*.jar๐ Build Guide โ
- Create a Workspace โ Local (personal) or Git (team)
- Create a Collection โ Organize your API requests
- Send Your First Request โ Enter URL, configure params, click Send
- Set Up Environments โ Switch between dev / test / prod easily
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.
| 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 |
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).
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
Thanks to these awesome open-source projects:
| Project | Role |
|---|---|
| FlatLaf | Modern Swing theme |
| RSyntaxTextArea | Syntax highlighting editor |
| OkHttp | HTTP client |
| Termora | Terminal emulator inspiration |



