<div align="center"> <img src="docs/icon.png" alt="EasyPostman Logo" width="100" />

EasyPostman

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

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

</div>

---

📖 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 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

<div align="center">

| Home | Workspaces | |:----:|:----------:| | | |

| Collections & API Testing | Performance Testing | |:-------------------------:|:-------------------:| | | |

</div>

📸 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

<details> <summary><b>Q: Why local storage instead of cloud sync?</b></summary>

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.

</details> <details> <summary><b>Q: How to import Postman data?</b></summary>

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

</details> <details> <summary><b>Q: Why does Windows/macOS show security warnings?</b></summary>

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

</details> <details> <summary><b>Q: Does it support team collaboration?</b></summary>

✅ Yes — use Git workspace to share collections & environments, track changes (commit/push/pull), and collaborate across devices without any cloud service.

</details> <details> <summary><b>Q: Are workspaces isolated?</b></summary>

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

</details> <details> <summary><b>Q: Which Git platforms are supported?</b></summary>

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

</details>

---

💖 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 —