Python SDK

Feature status

What the Python SDK supports today compared with TypeScript.

The Python SDK is in beta. This table tracks coverage against the TypeScript packages.

FeatureTypeScriptPython
Dimensions and base measuresAvailableAvailable
Filtered measuresAvailableAvailable
Filters on dimensions and declared filters with operator allowlistsAvailableAvailable
Null-check filters (isNull, isNotNull)AvailablePlanned. The protocol accepts them; Python datasets can't write them yet
Relationships (belongs_to, has_one, has_many)AvailableAvailable
Time grainsAvailableAvailable, including per-dataset time_grains restriction
Sync and async executionAvailableAvailable
Result caching and multi-tenancyAvailableAvailable
Dataset catalogAvailableAvailable
Typed DataFrames (to_pandas, to_polars, to_arrow)Not applicableAvailable
Framework integrationsNext.js, Node.js, Vite guidesDjango, Flask, SQLAlchemy (hypequery.contrib)
approxCountDistinct measuresAvailablePlanned
measure.merge over AggregatingMergeTree state columnsAvailablePlanned
final: true for ReplacingMergeTree / CollapsingMergeTree sourcesAvailablePlanned
Derived measuresAvailableAvailable (measure.derived with formula.*)
Window measures (trailing, to-date, cumulative)AvailablePlanned
Period comparisons (shift)AvailablePlanned
SegmentsAvailablePlanned
Relationship checksAvailableAvailable (check_relationships)
Cloud publishingNot yethypequery cloud is not live. Bundle export works today (write_dataset_bundle); one-step publish is planned
MCP server for AI agentsAvailableThrough the Node hypequery mcp bridge over the server's live client contract (setup); no native Python server
Tool generation for agentsAvailableUnder consideration
Serve: auth, CORS, rate limiting, errorsAvailableAvailable
Serve: JWT strategy and token issuerAvailableAvailable (jwt_strategy, analytics_token_issuer; tokens verify across languages)
Serve: your app's own login (fromContext)AvailableAvailable (from_context, django_user, flask_session)
Serve adaptersFetch, Node, VercelASGI, WSGI, native Django and Flask (to_asgi_app, to_wsgi_app, urls, blueprint)
Serve: dataset query endpoints and discoveryAvailableAvailable
CLI (init, generate datasets, dev, export client-contract)AvailableAvailable
Generated React hooksAvailableAvailable via exported client contracts and generate:client (setup)
Query builderAvailableNot planned
Named metricsAvailableNot planned. Use metric endpoints or derived measures

Get early access to hypequery cloud.

Cloud hosts the same model you run in your backend, with a managed API and MCP server, versions, and rollback. We're letting teams in a few at a time. Join the waitlist and we'll reach out when your project can go live.

How do you want to build your analytics layer? (Optional)
What features do you most need? (Optional)

Pick as many as you like.

Only your email is required. All other questions are optional.