็ฎไฝไธญๆ | English
๐ 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. Built-in Git integration for team collaboration and version control.
- โจ 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 Features - Simple yet powerful, rich features without bloat
- ๐ Privacy First - 100% local storage, no cloud sync, your data stays private
- ๐ Performance Oriented - 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
- Test Scripts - Assertions and response validation
- 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 | Download | Notes |
|---|---|---|
| ๐ macOS (Apple Silicon) | EasyPostman-{version}-macos-arm64.dmg |
For M1/M2/M3/M4 Macs |
| ๐ macOS (Intel) | EasyPostman-{version}-macos-x86_64.dmg |
For Intel-based Macs |
| ๐ช Windows (Installer) | EasyPostman-{version}-windows-x64.exe |
Installer with auto-update |
| ๐ช Windows (Portable) | EasyPostman-{version}-windows-x64-portable.zip |
No installation required |
| ๐ง Ubuntu/Debian | easypostman_{version}_amd64.deb |
DEB package |
| โ Cross-platform | easy-postman-{version}.jar |
Requires Java 17+ |
โ ๏ธ First Run Notice
- Windows: If you see SmartScreen warning โ Click "More info" โ "Run anyway"
- macOS: If "cannot be opened" โ Right-click app โ Select "Open" โ Click "Open"
The app is completely open-source and safe. These warnings appear because we don't purchase code signing certificates.
Due to storage limitations, Gitee mirror only provides:
- macOS (Apple Silicon) DMG
- Windows Installer and Portable ZIP
For other platforms, please use GitHub Releases.
- Download the appropriate package for your platform from Releases
- Install and run:
- macOS: Open DMG, drag to Applications
- Windows Installer: Run EXE, follow installation wizard
- Windows Portable: Extract ZIP, run
EasyPostman.exe - Linux DEB:
sudo dpkg -i easypostman_{version}_amd64.deb - JAR:
java -jar easy-postman-{version}.jar
# Clone repository
git clone https://github.com/lakernote/easy-postman.git
cd easy-postman
# Build and run
mvn clean package
java -jar target/easy-postman-*.jar๐ Build Guide โ
- Create a Workspace - Choose Local (personal) or Git (team collaboration)
- 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! Whether it's bug reports, feature requests, or code contributions.
- ๐ Report Bugs - Use our bug report template
- โจ Request Features - Share your ideas via feature request
- ๐ป Submit Code - Fork, code, and create a pull request
- ๐ Improve Docs - Fix typos, add examples, translate
When you submit a PR, it will automatically go through:
- โ Build and compilation check
- โ Test execution
- โ Code quality validation
- โ PR format verification
- ๐ Feature Details - Comprehensive feature documentation
- ๐๏ธ System Architecture - Technical stack and architecture
- ๐ Build Guide - Build from source and generate installers
- ๐ผ๏ธ Screenshots Gallery - All application screenshots
- ๐ Script API Reference - Pre-request and test script API
- ๐ Script Snippets Quick Reference - Built-in code snippets
- ๐ Client Certificates - mTLS configuration
- ๐ง Linux Build Guide - Building on Linux
- โ FAQ - Frequently asked questions
Q: Why local storage instead of cloud sync?
A: We value developer privacy. Local storage ensures your API data is never leaked to third parties. You can optionally use Git workspace for team collaboration while maintaining control over your data.
Q: How to import Postman data?
A: In the Collections view, click Import and select a Postman v2.1 JSON file. The tool will automatically convert collections, requests, and environments.
Q: Why does Windows/macOS show security warnings?
Windows SmartScreen: Not purchasing a code signing certificate (~$100-400/year) triggers warnings.
- Solution: Click "More info" โ "Run anyway"
- As download count increases, warnings will gradually decrease
macOS Gatekeeper: Not purchasing Apple Developer certificate ($99/year) + notarization triggers warnings.
- Solution: Right-click the app โ Select "Open"
- Or run in Terminal:
sudo xattr -rd com.apple.quarantine /Applications/EasyPostman.app
This project is completely open-source and the code can be reviewed on GitHub.
Q: Does it support team collaboration?
A: โ Yes! Use Git workspace to:
- Share API collections and environments with your team
- Track changes with version control (commit, push, pull)
- Work across multiple devices
- Collaborate without cloud services
Q: Are workspaces isolated from each other?
A: Yes. Each workspace is completely independent with its own collections, environments, and history. Switching workspaces provides full data isolation.
Q: Which Git platforms are supported?
A: All standard Git platforms including:
- GitHub
- Gitee
- GitLab
- Bitbucket
- Self-hosted Git servers
Just provide a standard Git URL (HTTPS or SSH).
If you find EasyPostman helpful:
- โญ Star this repo - Show your support!
- ๐ด Fork and contribute - Help make it better
- ๐ข Recommend to friends - Spread the word
- ๐ฌ Join WeChat group - Add lakernote for direct communication
- ๐ฌ GitHub Discussions - Ask questions and share ideas
- ๐ GitHub: https://github.com/lakernote/easy-postman
- ๐ Gitee: https://gitee.com/lakernote/easy-postman
- ๐ฌ Discussions: https://github.com/lakernote/easy-postman/discussions
- ๐ฆ Releases: https://github.com/lakernote/easy-postman/releases
Thanks to these awesome open-source projects:
- FlatLaf - Modern Swing theme
- RSyntaxTextArea - Syntax highlighting editor
- OkHttp - HTTP client
- Termora - Excellent terminal emulator
Make API debugging easier, make performance testing more intuitive
Made with โค๏ธ by laker