A fast, local-first desktop API client for REST, gRPC, WebSocket, Socket.IO, and GraphQL workflows.
No account required. No cloud sync forced. 100% local workspace ownership.
📖 Documentation • 🚀 Try Web Preview • 📦 Download Desktop App • 🗺️ Roadmap
KobeanREST is designed for software engineers, backend developers, and QA teams who need a high-performance API client without forced cloud lock-in or user registration. Download the app, launch it locally, and build, test, and debug REST, gRPC, WebSocket, Socket.IO, and GraphQL endpoints directly on your machine.
Local-First Contract: KobeanREST has no user accounts, no login screens, no cloud telemetry, and no required backend service. All workspace data is stored in local SQLite databases, and secret credentials remain safely secured in your operating system's native keychain.
| Feature | Description |
|---|---|
| ⚡ gRPC & Protobuf RPC Client | Native gRPC execution engine supporting Unary and Streaming calls with .proto IDL loading, service/method selection, sample payload synthesis, custom metadata headers, and latency metrics. |
| 🔌 WebSocket & Socket.IO Streaming | Real-time bidirectional message streaming with incoming/outgoing chronological timeline inspector, event emitters, JSON payload trees, and connection state indicators. |
| 📐 GraphQL Studio & Inspection | Query and variables editor with syntax highlighting, schema introspection support, and strict GraphQL-over-HTTP error & data status reporting (GraphQL OK, GraphQL Errors). |
| 🛠️ Local Mock Server & Starter Templates | Built-in multi-route HTTP/REST & gRPC mock server with 8 ready-to-use template presets (E-Commerce, OpenAI LLM, DevOps Health, Greeter, Echo Streaming) and Protobuf schema auto-generation. |
| 📥 Universal API Importer | 1-click import from cURL, Postman Collections, OpenAPI/Swagger 3.x, Insomnia, HAR, and .http files with draft preservation. |
| 🤖 AI Assistant & Session Manager | Built-in local/cloud AI Assistant supporting Ollama (Local), OpenAI, Anthropic, Gemini, Groq, OpenRouter, and custom endpoints. Features drag-to-resize sidebar (28%–48% window bounds), multi-session management, auto-titling, code copying, prompt suggestions, and automatic non-tool model fallbacks. |
| 🧩 Extensible Plugin System | Modular plugin runner with a rich built-in catalog (UUID Request ID, HMAC Signer, Response Time Logger, Rate Limit Checker, JSON Extractor, Status Asserters). |
| 🔐 Keychain Secret Protection | Sensitive values (API keys, tokens) stay outside SQLite in OS keychain / encrypted vault storage. |
| 🏃 Collection Runner | Execute entire collections sequentially with comprehensive run history and results tracking. |
| 📜 Pre & Post Request Scripts | Dynamic JavaScript execution environment with live logs, assertions, and variable injection. |
| 📊 QA Dashboard | Real-time test analytics, flakiness governance, and daily telemetry drilldown for automated tests. |
| 🌐 Live Web Preview | Try KobeanREST instantly in any modern web browser without installing local desktop binaries. |
gRPC & Protobuf Client: Interactive Proto loader, method selector, and decoded streaming response viewer.
WebSocket & Socket.IO: Real-time bi-directional streaming inspector and interactive event emitter.
Local Mock Server: Built-in multi-route REST & gRPC server with pre-configured starter templates.
QA Dashboard: Real-time test analytics, suite metrics, and flakiness telemetry drilldown.
Local Environment & Variables Editor: Keep secrets safe in your native OS keychain.
Pre & Post Request Scripts: Dynamic execution environment with tests, assertions, and live logs.
Interactive Query Params: Real-time bi-directional synchronization with the URL bar.
History Viewer: Detailed logging of past requests and replay functionality.
Official cross-platform installers are published through GitHub Releases:
👉 Download Latest Version (GitHub Releases)
| Platform | Installer Format | Architecture |
|---|---|---|
| macOS | .dmg |
Universal (Apple Silicon & Intel) |
| Windows | .msi |
x64 |
| Linux | .AppImage / .deb |
x64 |
Detailed installation instructions, checksum verification, and OS security notes are available in the Download Guide.
┌─────────────────────────────────────────────────────────────┐
│ React Renderer │
│ (Request Builder, Params Sync, Env Editor, Bottom Dock) │
└──────────────────────────────┬──────────────────────────────┘
│ Tauri IPC Bridge
┌──────────────────────────────▼──────────────────────────────┐
│ Rust Desktop Core │
│ (Reqwest HTTP Engine, SQLite Persistence, Keychain Vault) │
└─────────────────────────────────────────────────────────────┘
| Layer | Responsibility |
|---|---|
| Tauri 2 Shell | Native window management, desktop shortcuts, auto-updater integration |
| Rust Native Core | SQLite storage, HTTP client execution engine, OS keychain integrations |
| React Renderer | CodeMirror editor, dynamic variable resolution {{var}}, theme engines |
| Docs Portal | GitHub Pages documentation portal built from docs-site/ |
-
Clone & Install Dependencies:
git clone https://github.com/thienng-it/KobeanREST.git cd KobeanREST npm install -
Run Web Renderer (Dev Mode):
npm run dev
-
Run Native Desktop App:
npm run tauri dev
-
Execute Verification & Tests:
npm test # Run contract and unit test suite npm run build # Build TypeScript & Vite renderer npm run build:docs # Build documentation portal npm run check:secrets # Perform Betterleak sensitive-data scan npm run check:release # Run release preflight checks
KobeanREST is engineered to keep your workspace data private and local:
- Redacted Secret Exports: Workspace exports redact sensitive environment variables by default.
- Redacted History: Request history automatically masks sensitive URL query parameters and authorization headers.
- Automated Scanning: Every commit and PR is scanned for credential leaks via
Betterleakin CI (npm run check:secrets).
Distributed under the MIT License. Created and maintained with ❤️ by Joseph Thien and Kobenguyent.