OneOpen Postkid

Local-first Postman-style API client — a pure-Python desktop app with a red & white UI.

Collections, environments, cookies, flows, and history stay on your machine. No cloud account, no sync tax.

Install

Requires Python 3.10+.

pip install oneopen-postkid

Then launch:

postkid

Aliases that do the same thing:

oneopen-postkid
python -m oneopen_postkid

First launch may download a Flet desktop runtime. On Linux you may need system packages for the window toolkit — see Flet docs.

From source

git clone https://github.com/1-OpenSource/OneOpen-Postkid.git
cd OneOpen-Postkid
pip install -e .
postkid

Features

Requests & protocols

• HTTP request builder (method, URL, params, headers, body, auth)
• Protocols: HTTP, GraphQL, WebSocket, MQTT, SOAP/XML
• Body types: none, form-data, urlencoded, raw, JSON, GraphQL, SOAP, binary
• Path variables (:id / {id}) separate from query params
• Auto-name requests from the URL (Postman-style)
• Auto-format / beautify / minify JSON & XML

Auth

• Bearer, Basic, API Key
• OAuth 2.0 (client credentials + access token)
• Digest, Hawk, AWS Signature V4

Collections & environments

• Local collections with folders, duplicate / rename / move
• Environments, globals, and collection variables with {{var}} interpolation
• Environment quick-look and active-env switcher
• Import: Postman Collection v2.1, OpenAPI/Swagger, native JSON, cURL paste
• Export: native JSON or Postman Collection v2.1
• Collection Runner (iterations + delay)
• Flows — sequential multi-request runners

Scripts & tooling

• Pre-request & test scripts in Python (pm.* API)
• Console + embedded terminal (toggle from the footer)
• Code snippets (cURL and more)
• Find & replace across collections
• Cookies jar (view / edit / clear; auto-absorb Set-Cookie)
• History with search / filter / clear
• Request Docs and saved response examples

UX

• Postman-inspired dense chrome, red brand (#E11D48)
• Dark theme toggle
• Keyboard shortcuts: Ctrl+Enter send, Ctrl+S save, Ctrl+N new tab, Ctrl+F find
• Settings: timeout, redirects, SSL verify, proxy, HTTP/2, client certificates
• Custom window chrome with taskbar icon

Quick start

1. Install and run postkid.
2. Open the Getting Started collection (created on first launch).
3. Pick the Local environment (base_url points at JSONPlaceholder).
4. Hit Send.

Try a GraphQL or SOAP request by switching the protocol / body type on the request bar.

Data location

Everything is plain JSON under ~/.oneopen_postkid (or %USERPROFILE%\.oneopen_postkid on Windows):

Override the data directory:

# Windows (PowerShell)
$env:ONEOPEN_POSTKID_HOME = "D:\postkid-data"
postkid

# macOS / Linux
export ONEOPEN_POSTKID_HOME=/path/to/data
postkid

Keyboard shortcuts

Stack

Development

# Editable install + packaging tools
pip install -e ".[dev]"

# Smoke import
python -c "from oneopen_postkid import __version__; print(__version__)"

# Build sdist + wheel
python -m build

# Check metadata before upload (needs recent twine for Metadata 2.5)
python -m twine check dist/*

# Publish (maintainers) — create a PyPI API token first
python -m twine upload --repository testpypi dist/*
python -m twine upload dist/*

License

MIT © OneOpen / 1-OpenSource