ivo.zilkenat
  • Joined on 2025-10-29

convex-rpc (0.1.4)

Published 2026-06-12 13:37:26 +00:00 by ivo.zilkenat

Installation

pip install --index-url  --extra-index-url https://pypi.org/ convex-rpc

About this package

Generic, brand-neutral Convex RPC client — token→JWT exchange + query/mutation/action/paginate over the self-hosted HTTP API.

convex-rpc

Generic, brand-neutral Convex RPC client. Calls public Convex functions by name over the self-hosted HTTP API (POST {convex_url}/api/{query,mutation,action}), authenticated by an opaque API token exchanged for a short-lived RS256 user JWT at {site_url}/cli/token.

Dependency-light (httpx + pydantic), stateless about caching, and reads nothing from the environment in its constructor — pass config explicitly. It is the shared transport under branded SDKs such as plexus-sdk.

from convex_rpc import ConvexClient

client = ConvexClient(
    convex_url="https://db.example",      # /api/query|mutation|action
    site_url="https://actions.db.example", # /cli/token (auth exchange)
    token="…",                             # opaque API token
)
me = client.query("permissions:currentUserAccess", {})

Requirements

Requires Python: >=3.12
Details
PyPI
2026-06-12 13:37:26 +00:00
2
13 KiB
Assets (2)
Versions (5) View all
0.1.4 2026-06-12
0.1.3 2026-06-12
0.1.2 2026-06-12
0.1.1 2026-06-11
0.1.0 2026-06-11