Helix Query Authoring - Python

Write HelixDB Python SDK queries that are schema-aware, explicit, and easy for application code to call. The package is helix-db, imported as helixdb. The Python API is intentionally snake_case (read_batch, write_batch, var_as, value_map, to_dynamic_request) while keeping compatibility aliases for users translating TypeScript examples.

The Python DSL emits the same dynamic-query JSON AST as the Rust, TypeScript, and Go SDKs. Use the built-in Client to POST dynamic requests to /v1/query or stored route calls to /v1/query/{name}.

When To Use

Use this skill when the task is to:

• write a new Helix query in Python
• revise an existing Python query function
• produce a dynamic POST /v1/query request with to_dynamic_json / to_dynamic_request
• send a request with Client(...).query().dynamic(request).send()
• generate a query bundle with define_queries, register_read, and register_write
• add traversal, projection, pagination, BM25 text search, or vector search to Python code
• translate a Rust or TypeScript DSL query into Python

Do not use this skill for hand-authored JSON AST payloads; use helix-query-json-dynamic for wire-format work. For Rust, TypeScript, or Go source, use the language-specific skill.