picokvm-client 0.1.0__tar.gz

picokvm_client-0.1.0/.gitignore

@@ -0,0 +1,14 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+.venv/
+venv/
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+.coverage
+htmlcov/
+uv.lock

picokvm_client-0.1.0/CHANGELOG.md

@@ -0,0 +1,24 @@
+# Changelog
+
+All notable changes to `picokvm-client` are documented in this file.
+
+Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-06-23
+
+Initial release.
+
+### Added
+
+- `PicoKVMClient`: synchronous JSON-RPC 2.0 client for the Luckfox
+  PicoKVM HTTP API, built on `httpx` (transport and cookie auth) and
+  `jsonrpcclient` (request framing). Typed wrappers cover login, HID
+  input (type, click, key, combo), video state, virtual-media mount,
+  power and reset, and device introspection.
+- `rpc(method, **params)`: generic JSON-RPC call for any other device
+  method.
+- `PicoKVMError` hierarchy (`AuthError`, `TransportError`, `RpcError`)
+  rooted at the stdlib `Exception`, each with advisory `exit_code`,
+  `hint`, and `retryable` attributes.
+- `picokvm` command-line tool.

picokvm_client-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Onur Celep
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

picokvm_client-0.1.0/PKG-INFO

@@ -0,0 +1,177 @@
+Metadata-Version: 2.4
+Name: picokvm-client
+Version: 0.1.0
+Summary: Unofficial Python client for the Luckfox PicoKVM JSON-RPC API
+Project-URL: Homepage, https://github.com/onurcelep/picokvm-client
+Project-URL: Repository, https://github.com/onurcelep/picokvm-client
+Project-URL: Issues, https://github.com/onurcelep/picokvm-client/issues
+Author-email: Onur Celep <onurcelep@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: automation,hid,jetkvm,jsonrpc,kvm,picokvm
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: System :: Hardware
+Requires-Python: >=3.11
+Requires-Dist: click<9,>=8.1
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: jsonrpcclient>=4.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: typer>=0.9.0
+Provides-Extra: dev
+Requires-Dist: gitlint>=0.19.1; extra == 'dev'
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pre-commit>=3.5.0; extra == 'dev'
+Requires-Dist: pytest-mock>=3.12.0; extra == 'dev'
+Requires-Dist: pytest>=7.4.0; extra == 'dev'
+Requires-Dist: respx>=0.21.0; extra == 'dev'
+Requires-Dist: ruff>=0.8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# picokvm-client
+
+Python client for the [Luckfox PicoKVM](https://github.com/LuckfoxTECH/kvm).
+A thin, synchronous wrapper around its JSON-RPC 2.0 API (`POST /api/rpc`)
+and cookie-auth endpoint (`POST /auth/login-local`), built on `httpx` and
+`jsonrpcclient`.
+
+> **Unofficial.** Independent, community-built client. Not affiliated with,
+> authorized by, or endorsed by Luckfox or JetKVM. "PicoKVM" and "JetKVM"
+> belong to their respective owners and are used here only to describe
+> compatibility. No vendor source code is included; this reimplements the
+> device's public JSON-RPC protocol and standard USB HID Boot-Protocol
+> reports.
+
+## Compatibility
+
+Targets the Luckfox PicoKVM. Its firmware is a Luckfox-Pico fork of
+[JetKVM](https://github.com/jetkvm/kvm), so the wire protocol currently
+overlaps with JetKVM and its other forks. This client is only tested against
+the PicoKVM and makes no compatibility promise to JetKVM; a JetKVM is better
+served by a dedicated `jetkvm-client`.
+
+## Install
+
+```bash
+pip install picokvm-client
+# or
+uv add picokvm-client
+```
+
+## CLI
+
+The package installs a `picokvm` command:
+
+```bash
+export PICOKVM_URL=http://kvm.example PICOKVM_PASSWORD=hunter2
+
+picokvm ping
+picokvm device-id
+picokvm video-state
+picokvm type "hello world"
+picokvm combo "Ctrl+Alt+Del"
+picokvm rpc getJigglerState
+```
+
+`--url` and `--password` override the environment variables. Run
+`picokvm --help` for the full command list.
+
+> **Safety.** The HID commands (`type`, `key`, `combo`, `click`) inject input
+> into whatever host is attached to the KVM. A mistake can lock the keyboard,
+> type into the wrong window, or click at random coordinates. Test against a
+> throwaway target before using these in automation.
+
+## Library
+
+```python
+from picokvm_client import PicoKVMClient
+
+with PicoKVMClient("http://kvm.example", password="hunter2") as kvm:
+    if not kvm.ping():
+        raise RuntimeError("KVM not responding")
+
+    state = kvm.get_video_state()
+    print(f"Video: {state.width}x{state.height}, ready={state.ready}")
+
+    kvm.key_combo("Ctrl+Alt+Del")
+    kvm.type_text("hello world\n")
+    kvm.click(state.width // 2, state.height // 2)
+
+    kvm.mount_with_http("https://files.example.com/installer.iso")
+    kvm.trigger_reset()
+```
+
+The client owns an `httpx.Client` that holds the session cookie. Use it as a
+context manager so the connection pool and cookie are released on exit.
+
+## Methods
+
+Common operations have typed methods. Anything else on the device is reachable
+through `client.rpc(method, **params)`, a generic JSON-RPC call.
+
+| Family            | Typed methods                                                            | Via `.rpc()`       |
+|-------------------|--------------------------------------------------------------------------|--------------------|
+| HID input         | `keyboard_report`, `abs_mouse_report`, `rel_mouse_report`, `wheel_report`, `get_keyboard_led_state`, `send_usb_wakeup_signal`, `type_text`, `click`, `key_press`, `key_combo` | macros, layout get/set, jiggler |
+| Video             | `get_video_state`, `wait_for_video`                                      | EDID, capture      |
+| Virtual media     | `mount_with_http`, `mount_built_in_image`, `mount_with_storage`, `unmount_image` | upload, listing |
+| Device management | `get_device_id`, `ping`, `reboot`, `send_wol_magic_packet`              | network, OTA, logs |
+| Power             | `trigger_power`, `trigger_reset`                                         | hold-power         |
+| Auth              | `login` (called automatically by `__enter__` when a password is set)     | logout             |
+
+## Exceptions
+
+All exceptions inherit from `PicoKVMError` (itself a plain `Exception`, no
+third-party base). Each carries advisory `exit_code`, `hint`, and `retryable`
+attributes that a caller can map onto its own error type.
+
+| Exception        | Raised on                                                |
+|------------------|----------------------------------------------------------|
+| `AuthError`      | HTTP 401 from login or RPC                               |
+| `TransportError` | non-2xx HTTP (other than 401), invalid JSON, network failure |
+| `RpcError`       | a JSON-RPC 2.0 `error` response                          |
+| `PicoKVMError`   | base class for the above                                 |
+
+## Examples
+
+Runnable scripts in [examples/](examples/) (each reads `PICOKVM_URL` and
+`PICOKVM_PASSWORD`):
+
+| Script                                                            | What it does                                   |
+|------------------------------------------------------------------|------------------------------------------------|
+| [01_login_and_status.py](examples/01_login_and_status.py)        | Connect, ping, print device ID and video state |
+| [02_send_text_and_combo.py](examples/02_send_text_and_combo.py)  | Type a string and send a key combo             |
+| [03_mount_iso_and_reboot.py](examples/03_mount_iso_and_reboot.py)| Mount an ISO over HTTP and wait for boot        |
+
+## Testing
+
+Tests drive the client through `httpx.MockTransport`, so no sockets are
+opened. Each typed method asserts the exact JSON-RPC `method` and `params` it
+puts on the wire.
+
+The HID commands (`type_text`, `click`, `key_press`, `key_combo`) are checked
+at the payload level only, not against real hardware. Run a manual smoke test
+on a throwaway target before relying on them.
+
+## Development
+
+```bash
+uv sync --extra dev
+pre-commit install --install-hooks
+pre-commit install --hook-type commit-msg
+git config commit.template .gitmessage
+```
+
+Checks: `uv run pytest`, `uv run ruff check src tests`,
+`uv run mypy src/picokvm_client --strict`. Commit messages follow `.gitlint`
+(subject 10 to 72 chars, body wrapped at 72, `Signed-off-by` required, so use
+`git commit -s`).
+
+## Issues
+
+File issues at <https://github.com/onurcelep/picokvm-client/issues>.

picokvm_client-0.1.0/README.md

@@ -0,0 +1,141 @@
+# picokvm-client
+
+Python client for the [Luckfox PicoKVM](https://github.com/LuckfoxTECH/kvm).
+A thin, synchronous wrapper around its JSON-RPC 2.0 API (`POST /api/rpc`)
+and cookie-auth endpoint (`POST /auth/login-local`), built on `httpx` and
+`jsonrpcclient`.
+
+> **Unofficial.** Independent, community-built client. Not affiliated with,
+> authorized by, or endorsed by Luckfox or JetKVM. "PicoKVM" and "JetKVM"
+> belong to their respective owners and are used here only to describe
+> compatibility. No vendor source code is included; this reimplements the
+> device's public JSON-RPC protocol and standard USB HID Boot-Protocol
+> reports.
+
+## Compatibility
+
+Targets the Luckfox PicoKVM. Its firmware is a Luckfox-Pico fork of
+[JetKVM](https://github.com/jetkvm/kvm), so the wire protocol currently
+overlaps with JetKVM and its other forks. This client is only tested against
+the PicoKVM and makes no compatibility promise to JetKVM; a JetKVM is better
+served by a dedicated `jetkvm-client`.
+
+## Install
+
+```bash
+pip install picokvm-client
+# or
+uv add picokvm-client
+```
+
+## CLI
+
+The package installs a `picokvm` command:
+
+```bash
+export PICOKVM_URL=http://kvm.example PICOKVM_PASSWORD=hunter2
+
+picokvm ping
+picokvm device-id
+picokvm video-state
+picokvm type "hello world"
+picokvm combo "Ctrl+Alt+Del"
+picokvm rpc getJigglerState
+```
+
+`--url` and `--password` override the environment variables. Run
+`picokvm --help` for the full command list.
+
+> **Safety.** The HID commands (`type`, `key`, `combo`, `click`) inject input
+> into whatever host is attached to the KVM. A mistake can lock the keyboard,
+> type into the wrong window, or click at random coordinates. Test against a
+> throwaway target before using these in automation.
+
+## Library
+
+```python
+from picokvm_client import PicoKVMClient
+
+with PicoKVMClient("http://kvm.example", password="hunter2") as kvm:
+    if not kvm.ping():
+        raise RuntimeError("KVM not responding")
+
+    state = kvm.get_video_state()
+    print(f"Video: {state.width}x{state.height}, ready={state.ready}")
+
+    kvm.key_combo("Ctrl+Alt+Del")
+    kvm.type_text("hello world\n")
+    kvm.click(state.width // 2, state.height // 2)
+
+    kvm.mount_with_http("https://files.example.com/installer.iso")
+    kvm.trigger_reset()
+```
+
+The client owns an `httpx.Client` that holds the session cookie. Use it as a
+context manager so the connection pool and cookie are released on exit.
+
+## Methods
+
+Common operations have typed methods. Anything else on the device is reachable
+through `client.rpc(method, **params)`, a generic JSON-RPC call.
+
+| Family            | Typed methods                                                            | Via `.rpc()`       |
+|-------------------|--------------------------------------------------------------------------|--------------------|
+| HID input         | `keyboard_report`, `abs_mouse_report`, `rel_mouse_report`, `wheel_report`, `get_keyboard_led_state`, `send_usb_wakeup_signal`, `type_text`, `click`, `key_press`, `key_combo` | macros, layout get/set, jiggler |
+| Video             | `get_video_state`, `wait_for_video`                                      | EDID, capture      |
+| Virtual media     | `mount_with_http`, `mount_built_in_image`, `mount_with_storage`, `unmount_image` | upload, listing |
+| Device management | `get_device_id`, `ping`, `reboot`, `send_wol_magic_packet`              | network, OTA, logs |
+| Power             | `trigger_power`, `trigger_reset`                                         | hold-power         |
+| Auth              | `login` (called automatically by `__enter__` when a password is set)     | logout             |
+
+## Exceptions
+
+All exceptions inherit from `PicoKVMError` (itself a plain `Exception`, no
+third-party base). Each carries advisory `exit_code`, `hint`, and `retryable`
+attributes that a caller can map onto its own error type.
+
+| Exception        | Raised on                                                |
+|------------------|----------------------------------------------------------|
+| `AuthError`      | HTTP 401 from login or RPC                               |
+| `TransportError` | non-2xx HTTP (other than 401), invalid JSON, network failure |
+| `RpcError`       | a JSON-RPC 2.0 `error` response                          |
+| `PicoKVMError`   | base class for the above                                 |
+
+## Examples
+
+Runnable scripts in [examples/](examples/) (each reads `PICOKVM_URL` and
+`PICOKVM_PASSWORD`):
+
+| Script                                                            | What it does                                   |
+|------------------------------------------------------------------|------------------------------------------------|
+| [01_login_and_status.py](examples/01_login_and_status.py)        | Connect, ping, print device ID and video state |
+| [02_send_text_and_combo.py](examples/02_send_text_and_combo.py)  | Type a string and send a key combo             |
+| [03_mount_iso_and_reboot.py](examples/03_mount_iso_and_reboot.py)| Mount an ISO over HTTP and wait for boot        |
+
+## Testing
+
+Tests drive the client through `httpx.MockTransport`, so no sockets are
+opened. Each typed method asserts the exact JSON-RPC `method` and `params` it
+puts on the wire.
+
+The HID commands (`type_text`, `click`, `key_press`, `key_combo`) are checked
+at the payload level only, not against real hardware. Run a manual smoke test
+on a throwaway target before relying on them.
+
+## Development
+
+```bash
+uv sync --extra dev
+pre-commit install --install-hooks
+pre-commit install --hook-type commit-msg
+git config commit.template .gitmessage
+```
+
+Checks: `uv run pytest`, `uv run ruff check src tests`,
+`uv run mypy src/picokvm_client --strict`. Commit messages follow `.gitlint`
+(subject 10 to 72 chars, body wrapped at 72, `Signed-off-by` required, so use
+`git commit -s`).
+
+## Issues
+
+File issues at <https://github.com/onurcelep/picokvm-client/issues>.

picokvm_client-0.1.0/examples/01_login_and_status.py

@@ -0,0 +1,49 @@
+"""Example 01: connect, ping, print device ID and video state.
+
+Prerequisites:
+    export PICOKVM_URL=http://kvm.example
+    export PICOKVM_PASSWORD=hunter2  # omit if device is in noPassword mode
+
+What this script does:
+    Opens a session, verifies the firmware is responding, then prints
+    the device ID and HDMI input state.  No host-side side effects --
+    safe to run against any KVM you have access to.
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+
+from picokvm_client import PicoKVMClient, PicoKVMError
+
+
+def main() -> int:
+    url = os.environ.get("PICOKVM_URL")
+    if not url:
+        sys.stderr.write("error: set PICOKVM_URL\n")
+        return 2
+    password = os.environ.get("PICOKVM_PASSWORD")
+
+    try:
+        with PicoKVMClient(url, password=password) as kvm:
+            if not kvm.ping():
+                sys.stderr.write("KVM did not respond to ping\n")
+                return 1
+
+            print(f"device id: {kvm.get_device_id()}")
+
+            state = kvm.get_video_state()
+            print(
+                f"video    : {state.width}x{state.height} @ {state.fps:g}fps  "
+                f"ready={state.ready}  error={state.error!r}"
+            )
+    except PicoKVMError as exc:
+        sys.stderr.write(f"error: {exc}\n")
+        return exc.exit_code
+
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

picokvm_client-0.1.0/examples/02_send_text_and_combo.py

@@ -0,0 +1,41 @@
+"""Example 02: send keystrokes via the typed HID helpers.
+
+Prerequisites:
+    export PICOKVM_URL=http://kvm.example
+    export PICOKVM_PASSWORD=hunter2  # omit if device is in noPassword mode
+    Host attached to the KVM should be at a focused text input.
+
+What this script does:
+    Types a literal string and then issues a Ctrl+Alt+T combo.
+    BEWARE: this WILL inject characters into whatever has focus on the
+    host -- only run against a DUT you do not mind being typed into.
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+
+from picokvm_client import PicoKVMClient, PicoKVMError
+
+
+def main() -> int:
+    url = os.environ.get("PICOKVM_URL")
+    if not url:
+        sys.stderr.write("error: set PICOKVM_URL\n")
+        return 2
+    password = os.environ.get("PICOKVM_PASSWORD")
+
+    try:
+        with PicoKVMClient(url, password=password) as kvm:
+            kvm.type_text("hello world")
+            kvm.key_combo("Ctrl+Alt+T")
+    except PicoKVMError as exc:
+        sys.stderr.write(f"error: {exc}\n")
+        return exc.exit_code
+
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

picokvm_client-0.1.0/examples/03_mount_iso_and_reboot.py

@@ -0,0 +1,49 @@
+"""Example 03: mount an installer ISO over HTTP and trigger a reset.
+
+Prerequisites:
+    export PICOKVM_URL=http://kvm.example
+    export PICOKVM_PASSWORD=hunter2  # omit if device is in noPassword mode
+    export PICOKVM_INSTALLER_URL=https://files.example.com/installer.iso
+
+What this script does:
+    Mounts the ISO at PICOKVM_INSTALLER_URL as a virtual CD-ROM,
+    triggers a hard reset on the host so it boots from the new media,
+    then waits for the HDMI input to come back ready.
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+
+from picokvm_client import PicoKVMClient, PicoKVMError
+
+
+def main() -> int:
+    url = os.environ.get("PICOKVM_URL")
+    iso = os.environ.get("PICOKVM_INSTALLER_URL")
+    if not url or not iso:
+        sys.stderr.write("error: set PICOKVM_URL and PICOKVM_INSTALLER_URL\n")
+        return 2
+    password = os.environ.get("PICOKVM_PASSWORD")
+
+    try:
+        with PicoKVMClient(url, password=password) as kvm:
+            print(f"mounting {iso} ...")
+            kvm.mount_with_http(iso)
+
+            print("triggering reset ...")
+            kvm.trigger_reset()
+
+            print("waiting for video signal ...")
+            state = kvm.wait_for_video(timeout=120.0, poll_interval=2.0)
+            print(f"booted: {state.width}x{state.height} @ {state.fps:g}fps")
+    except PicoKVMError as exc:
+        sys.stderr.write(f"error: {exc}\n")
+        return exc.exit_code
+
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

picokvm_client-0.1.0/pyproject.toml

@@ -0,0 +1,85 @@
+[project]
+name = "picokvm-client"
+version = "0.1.0"
+description = "Unofficial Python client for the Luckfox PicoKVM JSON-RPC API"
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "MIT" }
+authors = [
+    { name = "Onur Celep", email = "onurcelep@gmail.com" },
+]
+keywords = ["picokvm", "kvm", "jsonrpc", "jetkvm", "automation", "hid"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Testing",
+    "Topic :: System :: Hardware",
+]
+
+dependencies = [
+    "httpx>=0.27.0",
+    "jsonrpcclient>=4.0.0",
+    "pydantic>=2.0.0",
+    "typer>=0.9.0",
+    "click>=8.1,<9",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.4.0",
+    "pytest-mock>=3.12.0",
+    "respx>=0.21.0",
+    "ruff>=0.8.0",
+    "mypy>=1.0.0",
+    "pre-commit>=3.5.0",
+    "gitlint>=0.19.1",
+]
+
+[project.scripts]
+picokvm = "picokvm_client._cli:app"
+
+[project.urls]
+Homepage = "https://github.com/onurcelep/picokvm-client"
+Repository = "https://github.com/onurcelep/picokvm-client"
+Issues = "https://github.com/onurcelep/picokvm-client/issues"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/picokvm_client"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/picokvm_client", "tests", "examples", "README.md", "CHANGELOG.md", "LICENSE"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py311"
+
+[tool.ruff.lint]
+select = [
+    "E",   # pycodestyle errors
+    "W",   # pycodestyle warnings
+    "F",   # pyflakes
+    "I",   # isort (import sorting)
+    "B",   # flake8-bugbear
+    "C4",  # flake8-comprehensions
+    "UP",  # pyupgrade
+]
+ignore = ["E501"]  # line length handled by the formatter
+
+[tool.ruff.lint.isort]
+known-first-party = ["picokvm_client"]
+
+[tool.mypy]
+python_version = "3.11"
+strict = true

picokvm_client-0.1.0/src/picokvm_client/__init__.py

@@ -0,0 +1,38 @@
+"""Python client for the Luckfox PicoKVM device.
+
+The PicoKVM exposes a JSON-RPC 2.0 API at ``POST /api/rpc`` (the same
+methods the web UI drives) plus a session-cookie auth endpoint at
+``POST /auth/login-local``.  This package is a thin, synchronous client
+on top of :mod:`httpx` and :mod:`jsonrpcclient` covering both.
+
+The PicoKVM firmware is a Luckfox-Pico-based fork of `JetKVM
+<https://github.com/jetkvm/kvm>`_; the wire protocol is largely shared
+with upstream and other forks today, but **this client makes no
+compatibility commitment** to JetKVM or its other forks.  The PicoKVM
+is the only device this library is tested against.  If you have a
+JetKVM, this library *might* work for the methods that haven't
+diverged — but a separate ``jetkvm-client`` package would be the right
+home for that contract.
+"""
+
+from __future__ import annotations
+
+from picokvm_client.client import PicoKVMClient
+from picokvm_client.exceptions import (
+    AuthError,
+    PicoKVMError,
+    RpcError,
+    TransportError,
+)
+from picokvm_client.methods import KeyboardLedState, UsbState, VideoState
+
+__all__ = [
+    "AuthError",
+    "KeyboardLedState",
+    "PicoKVMClient",
+    "PicoKVMError",
+    "RpcError",
+    "TransportError",
+    "UsbState",
+    "VideoState",
+]