---
id: convex
version: "0.7.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# convex — Python client for the reactive backend-as-a-service Convex.

License: permissive · Maintenance: active · Downloads: 95.1K/mo

## What it is and what it does

Convex is a Python client for the Convex backend-as-a-service platform. It allows you to call queries, mutations, and actions defined in your Convex backend from Python code, passing arguments and receiving results over HTTP. The client handles type conversion between Python and JavaScript (including special handling for Int64 via ConvexInt64), supports authentication via tokens, and provides subscription-based real-time updates. It also includes error handling for ConvexError exceptions propagated from backend functions.

The package is built with compiled wheels for broad platform support (x86_64, ARM, and other architectures across Linux, macOS, and musl systems). It has no runtime dependencies beyond Python itself, making it lightweight to install. The client is designed to integrate with Convex's cloud-hosted backend, requiring a deployment URL and knowledge of available RPC functions from the Convex dashboard.

Use it for:

- Call Convex backend queries from a Python script or application to fetch data without managing a separate database.
- Execute mutations from Python to write or update data in Convex, triggered by application logic or scheduled tasks.
- Subscribe to real-time updates from Convex queries to keep local state synchronized with backend changes.
- Authenticate Python clients with tokens from Convex authentication flows to enforce access control.
- Integrate Convex as the backend for a Python web service or CLI tool, delegating data persistence to the cloud.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Python client for Convex, a backend-as-a-service platform, enabling queries, mutations, and subscriptions to a Convex backend via RPC calls.

Yes, if you are already using Convex as your backend platform and need a Python client. The package is actively maintained, has no external dependencies, and supports current Python versions. The pre-1.0.0 status and stated willingness to make breaking changes warrant caution for long-term production use, but it is suitable for projects committed to tracking Convex's evolution. No known security vulnerabilities.

## Install

pip install convex
uv add convex
poetry add convex

## Installing convex

Before you install: Medium install friction due to compiled wheels for multiple architectures and Python versions. Package is actively maintained with recent releases; repo shows active development and reasonable community engagement.

License in practice: Licensed under Apache-2.0 (permissive), allowing commercial and private use with minimal restrictions—suitable for most projects.

Quickstart:

pip install convex

from convex import ConvexClient
client = ConvexClient('https://example-lion-123.convex.cloud')
messages = client.query("messages:list")
print(messages)

Requires Python 3.9 or later; Convex backend URL must be obtained from the Convex dashboard.

Verify before relying:

- Whether subscription streaming (client.subscribe) works reliably in production environments and what reconnection/error-recovery behavior is implemented.
- Performance characteristics and latency for large result sets or high-frequency queries.
- Support timeline and backwards-compatibility guarantees given the pre-1.0.0 status and stated willingness to make breaking changes.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 95.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

convex backend client, python backend-as-a-service, reactive database client, convex queries mutations, serverless backend python, convex rpc client, real-time data sync, backend-as-a-service, reactive-database, rpc-client

[View on SkillFed](https://skillfed.io/packages/convex) · [View on PyPI](https://pypi.org/project/convex/)