# EasyPostman
**Repository Path**: ssff_admin/EasyPostman
## Basic Information
- **Project Name**: EasyPostman
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-10
- **Last Updated**: 2026-02-24
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
[įŽäŊä¸æ](README_zh.md) | English
# EasyPostman
> đ 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.
---
## đ Table of Contents
- [⨠Features](#-features)
- [đĻ Download](#-download)
- [đ Quick Start](#-quick-start)
- [đŧī¸ Screenshots](#ī¸-screenshots)
- [đ¤ Contributing](#-contributing)
- [đ Documentation](#-documentation)
- [â FAQ](#-faq)
- [đ Support](#-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.
### đĨ Philosophy
- **đ¯ 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
---
## ⨠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 â](docs/FEATURES.md)**
---
## đĻ Download
### Latest Release
đ **[GitHub Releases](https://github.com/lakernote/easy-postman/releases)** | **[Gitee Mirror (China)](https://gitee.com/lakernote/easy-postman/releases)**
### Platform Downloads
| 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.
### Gitee Mirror (China) đ
Due to storage limitations, Gitee mirror only provides:
- macOS (Apple Silicon) DMG
- Windows Installer and Portable ZIP
For other platforms, please use GitHub Releases.
---
## đ Quick Start
### Option 1: Download Pre-built Release
1. Download the appropriate package for your platform from [Releases](https://github.com/lakernote/easy-postman/releases)
2. 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`
### Option 2: Build from Source
```bash
# 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 â](docs/BUILD.md)**
### First Steps
1. **Create a Workspace** - Choose Local (personal) or Git (team collaboration)
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
### Main Interface
### Workspace Management
### Collections & API Testing
### Performance Testing
đ¸ **[View All Screenshots â](docs/SCREENSHOTS.md)**
---
## đ¤ Contributing
We welcome all forms of contribution! Whether it's bug reports, feature requests, or code contributions.
### Ways to Contribute
- đ **Report Bugs** - Use our [bug report template](https://github.com/lakernote/easy-postman/issues/new/choose)
- ⨠**Request Features** - Share your ideas via [feature request](https://github.com/lakernote/easy-postman/issues/new/choose)
- đģ **Submit Code** - Fork, code, and create a pull request
- đ **Improve Docs** - Fix typos, add examples, translate
### Automated Checks
When you submit a PR, it will automatically go through:
- â
Build and compilation check
- â
Test execution
- â
Code quality validation
- â
PR format verification
đ **[Contributing Guide â](.github/CONTRIBUTING.md)**
---
## đ Documentation
- đ **[Feature Details](docs/FEATURES.md)** - Comprehensive feature documentation
- đī¸ **[System Architecture](docs/ARCHITECTURE.md)** - Technical stack and architecture
- đ **[Build Guide](docs/BUILD.md)** - Build from source and generate installers
- đŧī¸ **[Screenshots Gallery](docs/SCREENSHOTS.md)** - All application screenshots
- đ **[Script API Reference](docs/SCRIPT_API_REFERENCE_zh.md)** - Pre-request and test script API
- đ **[Script Snippets Quick Reference](docs/SCRIPT_SNIPPETS_QUICK_REFERENCE.md)** - Built-in code snippets
- đ **[Client Certificates](docs/CLIENT_CERTIFICATES.md)** - mTLS configuration
- đ§ **[Linux Build Guide](docs/LINUX_BUILD.md)** - Building on Linux
- â **[FAQ](docs/FQA.MD)** - Frequently asked questions
---
## â FAQ
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).
---
## đ Support the Project
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](https://github.com/lakernote/easy-postman/discussions)
---
## đ Links
- đ **GitHub**: [https://github.com/lakernote/easy-postman](https://github.com/lakernote/easy-postman)
- đ **Gitee**: [https://gitee.com/lakernote/easy-postman](https://gitee.com/lakernote/easy-postman)
- đŦ **Discussions**: [https://github.com/lakernote/easy-postman/discussions](https://github.com/lakernote/easy-postman/discussions)
- đĻ **Releases**: [https://github.com/lakernote/easy-postman/releases](https://github.com/lakernote/easy-postman/releases)
---
## â Star History
[](https://www.star-history.com/#lakernote/easy-postman&type=date&legend=top-left)
---
## đ Acknowledgements
Thanks to these awesome open-source projects:
- [FlatLaf](https://github.com/JFormDesigner/FlatLaf) - Modern Swing theme
- [RSyntaxTextArea](https://github.com/bobbylight/RSyntaxTextArea) - Syntax highlighting editor
- [OkHttp](https://github.com/square/okhttp) - HTTP client
- [Termora](https://github.com/TermoraDev/termora) - Excellent terminal emulator
---
**Make API debugging easier, make performance testing more intuitive**
Made with â¤ī¸ by [laker](https://github.com/lakernote)