Skill

hex-sdk-patterns

Applies Hex SDK patterns for TypeScript (retry, polling) and Python (hextoolkit client, Airflow operator) to run data projects reliably.

Typescript

Python

data-engineering

api-development

npx claudepluginhub jeremylongshore/claude-code-plugins-plus-skills --plugin hex-pack

Tool Access

This skill is limited to using the following tools:

ReadWriteEdit

Preview

Production patterns for Hex API: typed client, pipeline orchestration, retry logic, and Python integration.

SKILL.md

Similar Skills

hex-reference-architecture

1.9k

Provides Hex reference architecture with TypeScript project layouts, API client patterns, orchestration via Airflow/Dagster/GitHub Actions, and integration setups for data pipelines.

2 tools

hex-pack

coding-versori-sdk

Creates, debugs, and modifies TypeScript data integration workflows using versori-run SDK for ETL, API integrations, pipelines, database sync, webhooks, file processing, and real-time streaming.

4 files

versori-skills

hamilton-integrations

2.4k

Provides integration patterns for Hamilton dataflows with Airflow, Dagster, FastAPI, Streamlit, Jupyter notebooks, Flask, and more. Use for orchestration, APIs, dashboards, and experiment tracking.

5 tools

hamilton

Stats

Parent Repo Stars1854

Parent Repo Forks248

Last CommitMar 22, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Hex SDK Patterns

Overview

Production patterns for Hex API: typed client, pipeline orchestration, retry logic, and Python integration.

Instructions

Step 1: Run with Retry

async function runWithRetry(client: HexClient, projectId: string, params: Record<string, any>, maxRetries = 2) { for (let i = 0; i <= maxRetries; i++) { try { const { runId } = await client.runProject(projectId, params); const result = await pollUntilComplete(client, projectId, runId); return result; } catch (err: any) { if (i === maxRetries || !err.message.includes('429')) throw err; await new Promise(r => setTimeout(r, 30000)); // Wait 30s on rate limit } } }

Step 2: Python Client (hextoolkit)

# pip install hextoolkit from hextoolkit import HexAPI hex_api = HexAPI(token=os.environ['HEX_API_TOKEN']) # List projects projects = hex_api.list_projects() # Run project run = hex_api.run_project('project-id', input_params={'date': '2025-01-01'}) # Poll for completion status = hex_api.get_run_status('project-id', run['runId'])

Step 3: Airflow Integration

# Using the hex-inc/airflow-provider-hex package from airflow_provider_hex.operators.hex import HexRunProjectOperator run_task = HexRunProjectOperator( task_id='run_hex_project', project_id='your-project-id', input_params={'date': '{{ ds }}'}, hex_conn_id='hex_default', wait_for_completion=True, timeout=600, )

Resources

Next Steps

Apply patterns in hex-core-workflow-a.

Hex SDK Patterns

Overview

Production patterns for Hex API: typed client, pipeline orchestration, retry logic, and Python integration.

Instructions

Step 1: Run with Retry

async function runWithRetry(client: HexClient, projectId: string, params: Record<string, any>, maxRetries = 2) {
  for (let i = 0; i <= maxRetries; i++) {
    try {
      const { runId } = await client.runProject(projectId, params);
      const result = await pollUntilComplete(client, projectId, runId);
      return result;
    } catch (err: any) {
      if (i === maxRetries || !err.message.includes('429')) throw err;
      await new Promise(r => setTimeout(r, 30000)); // Wait 30s on rate limit
    }
  }
}

Step 2: Python Client (hextoolkit)

# pip install hextoolkit
from hextoolkit import HexAPI

hex_api = HexAPI(token=os.environ['HEX_API_TOKEN'])

# List projects
projects = hex_api.list_projects()

# Run project
run = hex_api.run_project('project-id', input_params={'date': '2025-01-01'})

# Poll for completion
status = hex_api.get_run_status('project-id', run['runId'])

Step 3: Airflow Integration

# Using the hex-inc/airflow-provider-hex package
from airflow_provider_hex.operators.hex import HexRunProjectOperator

run_task = HexRunProjectOperator(
    task_id='run_hex_project',
    project_id='your-project-id',
    input_params={'date': '{{ ds }}'},
    hex_conn_id='hex_default',
    wait_for_completion=True,
    timeout=600,
)

Resources

Next Steps

Apply patterns in hex-core-workflow-a.