---

📖 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 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
• Headless & Distributed Runs - Export plan.json from the GUI, then run it on servers with CLI or master/worker mode
• Global User Sharding - GUI virtual users are total concurrency; workers split continuous ranges and CSV rows follow the same ranges to avoid duplicates

📝 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
🐧 Linux AMD64 (Generic)	EasyPostman-{version}-linux-amd64.deb	For common x86_64 / amd64 Linux systems
🐧 Linux ARM64 (Generic)	EasyPostman-{version}-linux-arm64.deb	For common aarch64 / arm64 Linux systems
🐧 RHEL / Rocky / CentOS / Fedora (x64)	EasyPostman-{version}-1.x86_64.rpm	Available on GitHub Releases only
🐧 RHEL / Rocky / CentOS / Fedora (ARM64)	EasyPostman-{version}-1.aarch64.rpm	Available on GitHub Releases only
☕ 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. Linux DEB/RPM packages are published on GitHub Releases only.

---

🚀 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 (AMD64, Generic)	sudo dpkg -i EasyPostman-{version}-linux-amd64.deb
Linux DEB (ARM64, Generic)	sudo dpkg -i EasyPostman-{version}-linux-arm64.deb
Linux RPM (x64)	sudo rpm -ivh EasyPostman-{version}-1.x86_64.rpm
Linux RPM (ARM64)	sudo rpm -ivh EasyPostman-{version}-1.aarch64.rpm
JAR	java -jar easy-postman-{version}.jar

If you're not sure which Linux package to use, run uname -m first:

• x86_64 -> use EasyPostman-{version}-linux-amd64.deb or x86_64.rpm
• aarch64 -> use EasyPostman-{version}-linux-arm64.deb

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

📸 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
⚡ Distributed Performance Testing	GUI remote mode, CLI master/worker, CSV sharding, realtime refresh, and result details
🖼️ 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

---

🙏 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

---