ModuleX SDKs: JavaScript & Python overview

npm install modulex-js

pip install modulex-python

# The SDKs wrap this request shape. With cURL you set the headers yourself.
curl https://api.modulex.dev/auth/me \
  -H "Authorization: Bearer mx_live_your_api_key" \
  -H "X-Organization-ID: org_your_organization_id"

import asyncio
from modulex import Modulex

async def main():
    async with Modulex(
        api_key="mx_live_your_api_key",
        organization_id="org_your_organization_id",
    ) as client:
        me = await client.auth.me()
        print(me["email"])

asyncio.run(main())

import { Modulex } from "modulex-js";

const client = new Modulex({
  apiKey: "mx_live_your_api_key",
  organizationId: "org_your_organization_id",
});

const me = await client.auth.me();
console.log(me.email);

from modulex import Modulex

client = Modulex(
    api_key="mx_live_your_api_key",       # required (arg or MODULEX_API_KEY)
    organization_id="org_your_org_id",    # optional default org context
    base_url="https://api.modulex.dev",   # optional, this is the default
    timeout=30.0,                         # optional, seconds (default 30.0)
    max_retries=3,                        # optional (default 3)
    default_headers={"X-Trace": "demo"},  # optional, merged into every request
)

import { Modulex } from "modulex-js";

const client = new Modulex({
  apiKey: "mx_live_your_api_key",          // required
  organizationId: "org_your_org_id",       // optional default org context
  baseUrl: "https://api.modulex.dev",      // optional, this is the default
  timeout: 30000,                          // optional, milliseconds (default 30000)
  maxRetries: 3,                           // optional (default 3)
  fetch: customFetch,                      // optional, custom fetch implementation
});

curl https://api.modulex.dev/workflows \
  -H "Authorization: Bearer mx_live_your_api_key" \
  -H "X-Organization-ID: org_other_organization_id"

# Per-request override of the organization context
workflows = await client.workflows.list(
    organization_id="org_other_organization_id",
)

// Per-request override of the organization context
const { workflows } = await client.workflows.list(
  {},
  { organizationId: "org_other_organization_id" },
);

curl -X POST https://api.modulex.dev/workflows/run \
  -H "Authorization: Bearer mx_live_your_api_key" \
  -H "X-Organization-ID: org_your_organization_id" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "wf_your_workflow_id",
    "input": { "messages": [{ "role": "user", "content": "Hello" }] },
    "stream": true
  }'

run = await client.executions.run(
    workflow_id="wf_your_workflow_id",
    input={"messages": [{"role": "user", "content": "Hello"}]},
    stream=True,
)
print(run["run_id"], run["thread_id"])

const run = await client.executions.run({
  workflowId: "wf_your_workflow_id",
  input: { messages: [{ role: "user", content: "Hello" }] },
  stream: true,
});
console.log(run.run_id, run.thread_id);

from modulex import CreditExhaustedError, RateLimitError

try:
    run = await client.executions.run(workflow_id="wf_your_workflow_id")
except CreditExhaustedError as e:        # 402, layer="credit"
    print(f"Out of credits: {e.current}/{e.limit}")
except RateLimitError as e:              # 429
    print(f"Rate limited; retry after {e.retry_after}s")

import { ModulexError, RateLimitError } from "modulex-js";

try {
  const run = await client.executions.run({ workflowId: "wf_your_workflow_id" });
} catch (e) {
  if (e instanceof RateLimitError) {
    console.error(`Rate limited; retry after ${e.retryAfter}s`);
  } else if (e instanceof ModulexError) {
    // 402 billing denials surface here (no payment-specific class in JS)
    console.error(e.code, e.reason);
  }
}