EasyPostman

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

简体中文 · English · 📦 Download · 📖 Docs · 💬 Discuss

---

📖 Table of Contents

• 💡 About
• ✨ Features
• 📦 Download
• 🚀 Quick Start
• 🖼️ Screenshots
• 🤝 Contributing
• 📚 Documentation
• ❓ FAQ
• 💖 Support

---

💡 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
• 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)

🎨 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

Collections & API Testing	Performance Testing

📸 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
📝 Script Snippets	Built-in code snippet reference
🔐 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

---

🙏 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.

Made with ❤️ by laker